# Gunakan akses API

> Buat token akses pribadi untuk skrip dan klien MCP, lalu kirim peristiwa Livespace Anda ke sistem Anda sendiri dengan webhook.

Di Pengaturan › **Akses API**, Anda dapat membuat token akses pribadi agar skrip atau klien MCP dapat menggunakan Dvina atas nama Anda. Admin juga dapat menambahkan webhook di sana untuk mengirim peristiwa Livespace ke sistem mereka sendiri.

Akses API tersedia dalam paket Enterprise. Setiap anggota dapat membuat token sendiri; hanya pemilik dan admin yang dapat melihat **Webhook**.

## Buat token

1. Buka Pengaturan dan pilih **Akses API**.
2. Di bagian **Token Akses Pribadi**, pilih **Buat Token**.
3. Masukkan **Nama** agar nanti Anda tahu apa yang menggunakan token tersebut.
4. Pilih **Akses**: **Hanya baca** atau **Baca dan tulis**.
5. Pilih kapan token **Kedaluwarsa**: **Dalam 30 hari**, **Dalam 90 hari**, **Dalam 365 hari**, atau **Tidak pernah kedaluwarsa**.
6. Pilih **Buat Token**.
7. Di bagian **Salin Token Anda**, salin token dan simpan di tempat yang aman. Token hanya ditampilkan sekali ini.

Token bertindak atas nama Anda di Livespace tempat Anda membuatnya, dengan peran Anda saat ini di sana. Token **Hanya baca** dapat membaca, tetapi tidak dapat menambahkan atau mengubah apa pun.

Untuk menggunakan token dengan klien MCP, lihat [Hubungkan dengan kunci API, bukan OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Periksa, rotasi, atau cabut token

Token Anda tercantum di bagian **Token Akses Pribadi** beserta aksesnya. Pilih salah satu untuk melihat karakter **Diawali Dengan**, **Akses**, kapan token **Terakhir Digunakan**, dan kapan token **Kedaluwarsa**.

- **Untuk mengganti token**, pilih **Rotasi…**, lalu **Rotasi** untuk mengonfirmasi. Token baru menggantikannya, dan token lama langsung berhenti berfungsi. Salin token baru di bagian **Salin Token Anda**.
- **Untuk menonaktifkan token**, pilih **Cabut…**, lalu **Cabut** untuk mengonfirmasi. Apa pun yang menggunakan token tersebut langsung berhenti berfungsi.

Pembuatan, rotasi, dan pencabutan token dicatat dalam [log audit](/docs/teams/audit-log).

## Tambahkan webhook

Webhook mengirim peristiwa Livespace, yaitu catatan yang sama dengan [log audit](/docs/teams/audit-log), ke alamat yang Anda pilih.

1. Di Pengaturan › **Akses API**, pada bagian **Webhook**, pilih **Tambahkan Webhook**.
2. Masukkan **Nama** dan **URL**. Gunakan URL HTTPS publik.
3. Di bagian **Peristiwa**, biarkan kosong untuk menerima semua peristiwa, atau cantumkan tindakan dan area, seperti `member.added` atau `sharing.*`.
4. Pilih **Tambahkan**.
5. Di bagian **Salin Kunci Rahasia Penandatanganan**, salin kunci rahasia tersebut. Kunci rahasia hanya ditampilkan sekali ini.

Jika Dvina menampilkan **Alamat ini tidak dapat dijangkau dari Dvina**, gunakan URL HTTPS publik.

### Periksa tanda tangan setiap permintaan

Dvina mengirim peristiwa secara berkelompok dalam format JSON dan menandatangani setiap permintaan. Gunakan kunci rahasia penandatanganan untuk memastikan bahwa permintaan berasal dari Dvina:

- Setiap permintaan memiliki header `X-Dvina-Signature` seperti `t=<timestamp>,v1=<signature>`.
- Tanda tangan berupa HMAC-SHA256 dalam format heksadesimal, yang dibuat dari stempel waktu, tanda titik, dan isi permintaan menggunakan kunci rahasia penandatanganan Anda.
- Hitung sendiri tanda tangannya, lalu bandingkan. Tolak permintaan jika tanda tangannya tidak cocok atau stempel waktunya terlalu lama.

## Periksa atau ubah webhook

Webhook Anda tercantum di bagian **Webhook** beserta statusnya: **Aktif**, **Dijeda**, atau **Gagal**. Pilih salah satu untuk melihat detailnya.

- **Untuk mengubahnya**, edit **Nama**, **URL**, atau **Peristiwa**, lalu pilih **Simpan**.
- **Untuk menjedanya**, nonaktifkan **Kirim Peristiwa**. Aktifkan kembali untuk melanjutkan pengiriman.
- **Untuk memantau kinerjanya**, periksa **Status** dan jumlah peristiwa yang **Terkirim**. Webhook yang gagal menampilkan **Kesalahan Terakhir**. Dvina terus mencoba dan mencatat kegagalan tersebut di log audit.
- **Untuk mengubah rahasianya**, pilih **Rahasia Penandatanganan Baru…**, lalu konfirmasi. Permintaan langsung ditandatangani dengan rahasia baru, jadi segera perbarui penerimanya.
- **Untuk menghapusnya**, pilih **Hapus…**, lalu **Hapus** untuk mengonfirmasi. Tidak ada lagi yang dikirim ke webhook tersebut.

## Terkait

- [Gunakan Dvina dari aplikasi lain dengan MCP](/docs/dvina-mcp/overview)
- [Gunakan log audit](/docs/teams/audit-log)
- [Ikhtisar tim](/docs/teams/overview)