# Koristite API pristup

> Kreirajte lične pristupne tokene za skripte i MCP klijente te šaljite događaje iz svog prostora Livespace u vlastite sisteme putem webhookova.

U Postavke › **API pristup** kreirate lične pristupne tokene kako bi skripta ili MCP klijent mogli koristiti Dvina u vaše ime. Administratori tu dodaju i webhookove za slanje događaja iz prostora Livespace u vlastite sisteme.

API pristup dostupan je u paketu Enterprise. Svaki član može kreirati vlastite tokene; samo vlasnici i administratori vide **Webhookove**.

## Kreirajte token

1. Otvorite Postavke i odaberite **API pristup**.
2. U odjeljku **Lični pristupni tokeni** odaberite **Kreiraj token**.
3. Unesite **Naziv** kako biste kasnije znali za šta se token koristi.
4. Odaberite **Pristup**: **Samo čitanje** ili **Čitanje i pisanje**.
5. Odaberite kada token **Ističe**: **Za 30 dana**, **Za 90 dana**, **Za 365 dana** ili **Nikada ne ističe**.
6. Odaberite **Kreiraj token**.
7. U odjeljku **Kopirajte svoj token** kopirajte token i sačuvajte ga na sigurnom mjestu. Ovo je jedini put kada se prikazuje.

Token djeluje u vaše ime, u prostoru Livespace u kojem ste ga kreirali, s vašom trenutnom 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 OAuth-a](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Provjerite, rotirajte ili opozovite token

Vaši tokeni navedeni su u odjeljku **Lični pristupni tokeni**, uz prikaz njihovog pristupa. Odaberite token da vidite čime **Počinje**, njegov **Pristup**, kada je **Posljednji put korišten** i kada **Ističe**.

- **Da zamijenite token**, odaberite **Rotiraj…**, a zatim **Rotiraj** za potvrdu. Novi token zamjenjuje stari, a stari odmah prestaje raditi. Kopirajte novi token u odjeljku **Kopirajte svoj token**.
- **Da deaktivirate token**, odaberite **Opozovi…**, a zatim **Opozovi** za potvrdu. Sve što ga koristi odmah prestaje raditi.

Kreiranje, rotiranje i opozivanje tokena bilježi se u [dnevniku revizije](/docs/teams/audit-log).

## Dodajte webhook

Webhook šalje događaje iz prostora Livespace, iste zapise kao u [dnevniku revizije](/docs/teams/audit-log), na adresu koju odaberete.

1. U Postavke › **API pristup**, 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, kao što su `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 Dvina**, koristite javni HTTPS URL.

### Provjerite potpis svakog zahtjeva

Dvina šalje događaje u grupama, u JSON formatu, i potpisuje svaki zahtjev. Koristite tajni ključ za potpisivanje da provjerite je li zahtjev došao iz Dvina:

- Svaki zahtjev ima zaglavlje `X-Dvina-Signature` u obliku `t=<timestamp>,v1=<signature>`.
- Potpis je HMAC-SHA256 u heksadecimalnom obliku, izračunat nad vremenskom oznakom, tačkom i tijelom zahtjeva, uz korištenje vašeg tajnog ključa za potpisivanje.
- Izračunajte ga sami i uporedite. Odbijte zahtjev čiji se potpis ne podudara ili čija je vremenska oznaka prestara.

## Provjerite ili promijenite webhook

Vaši webhookovi navedeni su pod **Webhookovi**, uz njihov status: **Uključen**, **Pauziran** ili **Neuspješan**. Odaberite jedan da biste vidjeli njegove detalje.

- **Da biste ga promijenili**, uredite **Naziv**, **URL** ili **Događaje**, a zatim odaberite **Sačuvaj**.
- **Da biste ga pauzirali**, isključite **Šalji događaje**. Ponovo uključite ovu opciju da biste nastavili slanje.
- **Da biste provjerili kako radi**, pogledajte njegov **Status** i broj događaja pod **Poslano**. Webhook koji ne uspijeva prikazuje **Posljednju grešku**. Dvina nastavlja pokušavati i bilježi neuspjeh u dnevniku 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 prijemni sistem.
- **Da biste ga uklonili**, odaberite **Izbriši…**, a zatim **Izbriši** za potvrdu. Nakon toga mu se više ništa ne šalje.

## Povezano

- [Koristite Dvina iz drugih aplikacija putem MCP-a](/docs/dvina-mcp/overview)
- [Koristite dnevnik revizije](/docs/teams/audit-log)
- [Pregled timova](/docs/teams/overview)