Dvina MCP

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.

Ona kama Markdown

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.

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, ilipoTumiwa 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.

Ongeza webhook

Webhook hutuma matukio ya Livespace, ambayo ni rekodi zilezile zilizo kwenye kumbukumbu ya ukaguzi, 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.