# Gunakan akses API

> Cipta token akses peribadi untuk skrip dan klien MCP, dan hantar peristiwa Livespace anda ke sistem anda sendiri melalui webhook.

Dalam Tetapan › **Akses API**, anda boleh mencipta token akses peribadi supaya skrip atau klien MCP boleh menggunakan Dvina sebagai anda. Pentadbir juga boleh menambah webhook di situ untuk menghantar peristiwa Livespace ke sistem mereka sendiri.

Akses API disertakan dalam pelan Enterprise. Setiap ahli boleh mencipta token sendiri; hanya pemilik dan pentadbir dapat melihat **Webhook**.

## Cipta token

1. Buka Tetapan dan pilih **Akses API**.
2. Di bawah **Token Akses Peribadi**, pilih **Cipta Token**.
3. Masukkan **Nama** supaya anda tahu kegunaannya nanti.
4. Pilih **Akses**: **Baca sahaja** atau **Baca dan tulis**.
5. Pilih masa token **Tamat Tempoh**: **Dalam 30 hari**, **Dalam 90 hari**, **Dalam 365 hari** atau **Tidak pernah tamat tempoh**.
6. Pilih **Cipta Token**.
7. Di bawah **Salin Token Anda**, salin token dan simpan di tempat yang selamat. Token hanya dipaparkan pada kali ini.

Token bertindak sebagai anda dalam Livespace tempat anda menciptanya, dengan peranan semasa anda di situ. Token **Baca sahaja** boleh membaca tetapi tidak boleh menambah atau mengubah apa-apa.

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

## Semak, putar atau batalkan token

Token anda disenaraikan di bawah **Token Akses Peribadi** berserta aksesnya. Pilih satu untuk melihat aksara awalnya di **Bermula Dengan**, **Akses**nya, masa ia **Terakhir Digunakan** dan masa ia **Tamat Tempoh**.

- **Untuk menggantikan token**, pilih **Putar…**, kemudian **Putar** untuk mengesahkan. Token baharu menggantikannya, dan token lama berhenti berfungsi serta-merta. Salin token baharu di bawah **Salin Token Anda**.
- **Untuk menghentikan token**, pilih **Batalkan…**, kemudian **Batalkan** untuk mengesahkan. Apa-apa yang menggunakannya berhenti berfungsi serta-merta.

Penciptaan, pemutaran dan pembatalan token direkodkan dalam [log audit](/docs/teams/audit-log).

## Tambah webhook

Webhook menghantar peristiwa Livespace, iaitu rekod yang sama seperti dalam [log audit](/docs/teams/audit-log), ke alamat yang anda pilih.

1. Dalam Tetapan › **Akses API**, di bawah **Webhook**, pilih **Tambah Webhook**.
2. Masukkan **Nama** dan **URL**. Gunakan URL HTTPS awam.
3. Di bawah **Peristiwa**, biarkan kosong untuk menerima semua peristiwa, atau senaraikan tindakan dan bahagian, seperti `member.added` atau `sharing.*`.
4. Pilih **Tambah**.
5. Di bawah **Salin Rahsia Penandatanganan**, salin rahsia tersebut. Rahsia ini hanya dipaparkan pada kali ini.

Jika Dvina menyatakan **Alamat ini tidak dapat dicapai dari Dvina**, gunakan URL HTTPS awam.

### Semak tandatangan setiap permintaan

Dvina menghantar peristiwa secara berkelompok dalam format JSON dan menandatangani setiap permintaan. Gunakan rahsia penandatanganan untuk menyemak bahawa permintaan datang daripada Dvina:

- Setiap permintaan mempunyai pengepala `X-Dvina-Signature` seperti `t=<timestamp>,v1=<signature>`.
- Tandatangan ialah HMAC-SHA256 dalam format heksadesimal bagi cap masa, tanda noktah dan badan permintaan, yang dijana menggunakan rahsia penandatanganan anda.
- Kira sendiri dan bandingkan. Tolak permintaan jika tandatangannya tidak sepadan atau cap masanya terlalu lama.

## Semak atau ubah webhook

Webhook anda disenaraikan di bawah **Webhook** bersama statusnya: **Aktif**, **Dijeda** atau **Gagal**. Pilih satu untuk melihat butirannya.

- **Untuk mengubahnya**, edit **Nama**, **URL** atau **Peristiwa**, kemudian pilih **Simpan**.
- **Untuk menjedakannya**, matikan **Hantar Peristiwa**. Hidupkan semula untuk meneruskan penghantaran.
- **Untuk menyemak keadaannya**, semak **Status** dan bilangan peristiwa yang **Dihantar**. Webhook yang gagal memaparkan **Ralat Terakhir**. Dvina terus mencuba dan merekodkan kegagalan dalam log audit.
- **Untuk menukar rahsianya**, pilih **Rahsia Penandatanganan Baharu…**, kemudian sahkan. Permintaan ditandatangani dengan rahsia baharu serta-merta, jadi kemas kini penerima dengan segera.
- **Untuk membuangnya**, pilih **Padam…**, kemudian **Padam** untuk mengesahkan. Tiada apa-apa lagi dihantar kepadanya.

## Berkaitan

- [Gunakan Dvina daripada aplikasi lain dengan MCP](/docs/dvina-mcp/overview)
- [Gunakan log audit](/docs/teams/audit-log)
- [Gambaran keseluruhan pasukan](/docs/teams/overview)