Dvina MCP

Koristite pristup API-ju

Izradite osobne pristupne tokene za skripte i MCP klijente te šaljite događaje iz svojeg prostora Livespace u vlastite sustave putem webhookova.

Prikaži kao Markdown

U Postavkama › Pristup API-ju izrađujete osobne pristupne tokene kako bi skripta ili MCP klijent mogli koristiti Dvina u vaše ime. Administratori ondje dodaju i webhookove za slanje događaja iz prostora Livespace u vlastite sustave.

Pristup API-ju uključen je u plan Enterprise. Svaki član može izraditi vlastite tokene; samo vlasnici i administratori vide Webhookove.

Izradite token

  1. Otvorite Postavke i odaberite Pristup API-ju.
  2. U odjeljku Osobni pristupni tokeni odaberite Izradi token.
  3. Unesite Naziv kako biste kasnije znali što ga koristi.
  4. Odaberite Pristup: Samo čitanje ili Čitanje i pisanje.
  5. Odaberite kada token Istječe: Za 30 dana, Za 90 dana, Za 365 dana ili Nikad ne istječe.
  6. Odaberite Izradi token.
  7. U odjeljku Kopirajte svoj token kopirajte token i spremite ga na sigurno mjesto. Ovo je jedini put kada se prikazuje.

Token djeluje u vaše ime, u prostoru Livespace u kojem ste ga izradili, s vašom trenutačnom ulogom u tom prostoru. Token s pristupom Samo čitanje može čitati, ali ne može ništa dodavati ni mijenjati.

Za korištenje tokena s MCP klijentom pogledajte Povežite se API ključem umjesto putem OAutha.

Provjerite, zamijenite ili opozovite token

Vaši su tokeni navedeni u odjeljku Osobni pristupni tokeni, zajedno s razinom pristupa. Odaberite token da biste vidjeli podatke Počinje s, Pristup, Posljednje korištenje i Istječe.

  • Za zamjenu tokena odaberite Zamijeni…, a zatim Zamijeni za potvrdu. Novi token zamjenjuje postojeći, a stari odmah prestaje raditi. Kopirajte novi token u odjeljku Kopirajte svoj token.
  • Za zaustavljanje tokena odaberite Opozovi…, a zatim Opozovi za potvrdu. Sve što ga koristi odmah prestaje raditi.

Izrada, zamjena i opoziv tokena bilježe se u zapisniku revizije.

Dodajte webhook

Webhook šalje događaje iz prostora Livespace, iste zapise kao u zapisniku revizije, na adresu koju odaberete.

  1. U Postavkama › Pristup API-ju, u odjeljku Webhookovi, odaberite Dodaj webhook.
  2. Unesite Naziv i URL. Koristite javni HTTPS URL.
  3. Polje Događaji ostavite prazno za sve događaje ili navedite radnje i područja, primjerice member.added ili sharing.*.
  4. Odaberite Dodaj.
  5. U odjeljku Kopirajte tajni ključ za potpisivanje kopirajte tajni ključ. Ovo je jedini put kada se prikazuje.

Ako Dvina prikaže poruku Ova adresa nije dostupna iz usluge Dvina, koristite javni HTTPS URL.

Provjerite potpis svakog zahtjeva

Dvina šalje događaje u skupinama, u formatu JSON, i potpisuje svaki zahtjev. Upotrijebite tajni ključ za potpisivanje kako biste provjerili je li zahtjev poslala Dvina:

  • Svaki zahtjev ima zaglavlje X-Dvina-Signature u obliku t=<timestamp>,v1=<signature>.
  • Potpis je HMAC-SHA256 u heksadekadskom obliku, izračunan iz vremenske oznake, točke i tijela zahtjeva pomoću vašeg tajnog ključa za potpisivanje.
  • Izračunajte ga sami i usporedite. Odbijte zahtjev čiji se potpis ne podudara ili čija je vremenska oznaka prestara.

Provjerite ili promijenite webhook

Vaši su webhookovi navedeni u odjeljku Webhookovi sa statusom: Uključen, Pauziran ili Neuspješan. Odaberite webhook da biste vidjeli pojedinosti.

  • Da biste ga promijenili, uredite Naziv, URL ili Događaje, a zatim odaberite Spremi.
  • Da biste ga pauzirali, isključite Šalji događaje. Ponovno uključite tu opciju da biste nastavili slati događaje.
  • Da biste provjerili kako radi, pogledajte njegov Status i koliko je događaja Poslano. Webhook koji ne uspijeva slati događaje prikazuje Posljednju pogrešku. Dvina nastavlja pokušavati i bilježi neuspjeh u zapisnik revizije.
  • Da biste promijenili njegovu tajnu za potpisivanje, odaberite Nova tajna za potpisivanje…, a zatim potvrdite. Zahtjevi se odmah potpisuju novom tajnom, pa odmah ažurirajte primatelja.
  • Da biste ga uklonili, odaberite Izbriši…, a zatim Izbriši za potvrdu. Više mu se ništa ne šalje.