Dvina MCP

Gamitin ang access sa API

Gumawa ng mga personal access token para sa mga script at MCP client, at ipadala ang mga event ng iyong Livespace sa sarili mong mga system gamit ang mga webhook.

Tingnan bilang Markdown

Sa Mga Setting › Access sa API, makakagawa ka ng mga personal access token para magamit ng isang script o MCP client ang Dvina bilang ikaw. Dito rin nagdaragdag ang mga admin ng mga webhook para ipadala ang mga event ng Livespace sa sarili nilang mga system.

Kasama sa Enterprise plan ang Access sa API. Bawat miyembro ay puwedeng gumawa ng sarili nilang mga token; mga may-ari at admin lang ang nakakakita ng Mga Webhook.

Gumawa ng token

  1. Buksan ang Mga Setting at piliin ang Access sa API.
  2. Sa ilalim ng Mga Personal Access Token, piliin ang Gumawa ng Token.
  3. Maglagay ng Pangalan para matukoy mo sa ibang pagkakataon kung ano ang gumagamit nito.
  4. Piliin ang Access: Pagbasa lang o Pagbasa at pagsulat.
  5. Piliin kung kailan ito Mag-e-expire: Pagkalipas ng 30 araw, Pagkalipas ng 90 araw, Pagkalipas ng 365 araw o Hindi kailanman mag-e-expire.
  6. Piliin ang Gumawa ng Token.
  7. Sa ilalim ng Kopyahin ang Iyong Token, kopyahin ang token at itago ito sa isang ligtas na lugar. Dito lang ito ipapakita.

Gumagana ang token bilang ikaw, sa Livespace kung saan mo ito ginawa, gamit ang kasalukuyan mong tungkulin doon. Ang token na may access na Pagbasa lang ay puwedeng magbasa pero hindi puwedeng magdagdag o magbago ng anuman.

Para gumamit ng token sa isang MCP client, tingnan ang Kumonekta gamit ang API key sa halip na OAuth.

Suriin, palitan o bawiin ang token

Nakalista ang iyong mga token sa ilalim ng Mga Personal Access Token, kasama ang access ng mga ito. Pumili ng isa para makita kung saan ito Nagsisimula, ang Access nito, kung kailan ito Huling Ginamit at kung kailan ito Mag-e-expire.

  • Para palitan ang token, piliin ang Palitan…, pagkatapos ay Palitan para kumpirmahin. Papalitan ito ng bagong token, at agad na titigil sa paggana ang luma. Kopyahin ang bagong token sa ilalim ng Kopyahin ang Iyong Token.
  • Para ihinto ang token, piliin ang Bawiin…, pagkatapos ay Bawiin para kumpirmahin. Agad na titigil sa paggana ang anumang gumagamit nito.

Itinatala sa audit log ang paggawa, pagpapalit at pagbawi ng token.

Magdagdag ng webhook

Ipinapadala ng webhook sa address na pinili mo ang mga event ng Livespace—ang parehong mga tala na nasa audit log.

  1. Sa Mga Setting › Access sa API, sa ilalim ng Mga Webhook, piliin ang Magdagdag ng Webhook.
  2. Maglagay ng Pangalan at URL. Gumamit ng pampublikong HTTPS URL.
  3. Sa ilalim ng Mga Event, iwan itong blangko para sa lahat ng event, o ilista ang mga aksyon at saklaw, tulad ng member.added o sharing.*.
  4. Piliin ang Idagdag.
  5. Sa ilalim ng Kopyahin ang Signing Secret, kopyahin ang secret. Dito lang ito ipapakita.

Kung sabihin ng Dvina na Hindi maabot ng Dvina ang address na ito, gumamit ng pampublikong HTTPS URL.

Suriin ang signature ng bawat request

Ipinapadala ng Dvina ang mga event nang magkakabatch, bilang JSON, at nilalagdaan ang bawat request. Gamitin ang signing secret para suriin kung galing sa Dvina ang isang request:

  • Bawat request ay may X-Dvina-Signature header na tulad ng t=<timestamp>,v1=<signature>.
  • Ang signature ay isang HMAC-SHA256 sa hex, na binubuo mula sa timestamp, isang tuldok, at ang request body, gamit ang iyong signing secret.
  • Kalkulahin ito mismo at ihambing. Tanggihan ang request kung hindi tugma ang signature nito o kung masyado nang luma ang timestamp nito.

Suriin o baguhin ang isang webhook

Nakalista ang iyong mga webhook sa ilalim ng Mga webhook, kasama ang kanilang status: Naka-on, Naka-pause o Pumapalya. Pumili ng isa para makita ang mga detalye nito.

  • Para baguhin ito, i-edit ang Pangalan, URL o Mga event nito, pagkatapos ay piliin ang I-save.
  • Para i-pause ito, i-off ang Magpadala ng mga event. I-on itong muli para magpatuloy sa pagpapadala.
  • Para tingnan kung gumagana ito, suriin ang Status nito at kung ilang event ang Naipadala. Ipinapakita ng pumapalyang webhook ang Huling error nito. Patuloy na sumusubok ang Dvina at itinatala ang pagkabigo sa audit log.
  • Para baguhin ang signing secret nito, piliin ang Bagong signing secret…, pagkatapos ay kumpirmahin. Agad na ginagamit ang bagong secret sa paglagda sa mga request, kaya i-update kaagad ang tumatanggap ng mga ito.
  • Para alisin ito, piliin ang Tanggalin…, pagkatapos ay Tanggalin para kumpirmahin. Wala nang ipapadala rito.