# 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.

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](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## 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](/docs/teams/audit-log).

## Dodajte webhook

Webhook šalje događaje iz prostora Livespace, iste zapise kao u [zapisniku revizije](/docs/teams/audit-log), 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.

## Povezano

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