# Tumia ufikiaji wa API

> Unda tokeni za ufikiaji binafsi kwa skripti na wateja wa MCP, na utume matukio ya Livespace yako kwenye mifumo yako mwenyewe kwa kutumia webhook.

Katika Mipangilio › **Ufikiaji wa API**, unaweza kuunda tokeni za ufikiaji binafsi ili skripti au mteja wa MCP aweze kutumia Dvina kwa niaba yako. Wasimamizi pia huongeza webhook hapo ili kutuma matukio ya Livespace kwenye mifumo yao wenyewe.

Ufikiaji wa API unapatikana kwenye mpango wa Enterprise. Kila mwanachama anaweza kuunda tokeni zake mwenyewe; wamiliki na wasimamizi pekee ndio wanaoona **Webhook**.

## Unda tokeni

1. Fungua Mipangilio na uchague **Ufikiaji wa API**.
2. Chini ya **Tokeni za Ufikiaji Binafsi**, chagua **Unda Tokeni**.
3. Weka **Jina** ili baadaye ujue kinachoitumia.
4. Chagua **Ruhusa**: **Kusoma tu** au **Kusoma na kuandika**.
5. Chagua wakati **Inaisha muda**: **Baada ya siku 30**, **Baada ya siku 90**, **Baada ya siku 365** au **Haiishi muda**.
6. Chagua **Unda Tokeni**.
7. Chini ya **Nakili Tokeni Yako**, nakili tokeni na uihifadhi mahali salama. Huu ndio wakati pekee inapoonyeshwa.

Tokeni hufanya kazi kwa niaba yako katika Livespace ambamo uliiunda, kwa kutumia jukumu lako la sasa humo. Tokeni ya **Kusoma tu** inaweza kusoma lakini haiwezi kuongeza au kubadilisha chochote.

Ili kutumia tokeni na mteja wa MCP, angalia [Unganisha kwa ufunguo wa API badala ya OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Kagua, badilisha au batilisha tokeni

Tokeni zako zimeorodheshwa chini ya **Tokeni za Ufikiaji Binafsi** pamoja na ruhusa zake. Chagua moja ili kuona **Inaanza na** nini, **Ruhusa** zake, ilipo**Tumiwa Mara ya Mwisho** na wakati **Inaisha muda**.

- **Ili kubadilisha tokeni**, chagua **Badilisha…**, kisha **Badilisha** ili kuthibitisha. Tokeni mpya inachukua nafasi yake, na ya zamani inaacha kufanya kazi mara moja. Nakili tokeni mpya chini ya **Nakili Tokeni Yako**.
- **Ili kusimamisha tokeni**, chagua **Batilisha…**, kisha **Batilisha** ili kuthibitisha. Chochote kinachoitumia kinaacha kufanya kazi mara moja.

Kuunda, kubadilisha na kubatilisha tokeni hurekodiwa kwenye [kumbukumbu ya ukaguzi](/docs/teams/audit-log).

## Ongeza webhook

Webhook hutuma matukio ya Livespace, ambayo ni rekodi zilezile zilizo kwenye [kumbukumbu ya ukaguzi](/docs/teams/audit-log), kwenye anwani unayochagua.

1. Katika Mipangilio › **Ufikiaji wa API**, chini ya **Webhook**, chagua **Ongeza Webhook**.
2. Weka **Jina** na **URL**. Tumia URL ya HTTPS inayofikika kwa umma.
3. Chini ya **Matukio**, acha sehemu hiyo tupu ili kupata kila tukio, au orodhesha vitendo na maeneo, kama vile `member.added` au `sharing.*`.
4. Chagua **Ongeza**.
5. Chini ya **Nakili Siri ya Kutia Saini**, nakili siri hiyo. Huu ndio wakati pekee inapoonyeshwa.

Ikiwa Dvina inasema **Anwani hii haiwezi kufikiwa kutoka Dvina**, tumia URL ya HTTPS inayofikika kwa umma.

### Kagua saini ya kila ombi

Dvina hutuma matukio kwa mafungu katika muundo wa JSON, na hutia saini kila ombi. Tumia siri ya kutia saini ili kukagua kwamba ombi limetoka Dvina:

- Kila ombi lina kichwa cha `X-Dvina-Signature` kama `t=<timestamp>,v1=<signature>`.
- Saini ni HMAC-SHA256, katika muundo wa heksadesimali, ya muhuri wa muda, nukta na mwili wa ombi, iliyoundwa kwa kutumia siri yako ya kutia saini.
- Ikokotoe mwenyewe na ulinganishe. Kataa ombi ambalo saini yake hailingani au ambalo muhuri wake wa muda ni wa zamani sana.

## Kagua au badilisha webhook

Webhook zako zimeorodheshwa chini ya **Webhook** pamoja na hali zake: **Imewashwa**, **Imesitishwa** au **Inashindwa**. Chagua moja ili kuona maelezo yake.

- **Ili kuibadilisha**, hariri **Jina**, **URL** au **Matukio** yake, kisha uchague **Hifadhi**.
- **Ili kuisitisha**, zima **Tuma Matukio**. Washa tena ili kuanza kutuma tena.
- **Ili kuona jinsi inavyofanya kazi**, kagua **Hali** yake na idadi ya matukio **Yaliyotumwa**. Webhook inayoshindwa huonyesha **Hitilafu ya Mwisho**. Dvina huendelea kujaribu, na hurekodi kushindwa huko kwenye kumbukumbu ya ukaguzi.
- **Ili kubadilisha siri yake**, chagua **Siri Mpya ya Kutia Saini…**, kisha uthibitishe. Maombi hutiwa saini kwa siri mpya mara moja, kwa hivyo sasisha mfumo unaoyapokea mara moja.
- **Ili kuiondoa**, chagua **Futa…**, kisha **Futa** ili kuthibitisha. Hakuna kitu kingine kitakachotumwa kwake.

## Yanayohusiana

- [Tumia Dvina kutoka kwenye programu nyingine kupitia MCP](/docs/dvina-mcp/overview)
- [Tumia kumbukumbu ya ukaguzi](/docs/teams/audit-log)
- [Muhtasari wa timu](/docs/teams/overview)