# Folosește accesul API

> Creează tokenuri de acces personal pentru scripturi și clienți MCP și trimite evenimentele din Livespace către propriile sisteme prin webhookuri.

În Setări › **Acces API**, creezi tokenuri de acces personal, astfel încât un script sau un client MCP să poată folosi Dvina în numele tău. Administratorii adaugă tot acolo webhookuri pentru a trimite evenimentele din Livespace către propriile sisteme.

Accesul API este inclus în planul Enterprise. Fiecare membru își poate crea propriile tokenuri; doar proprietarii și administratorii văd **Webhookuri**.

## Creează un token

1. Deschide Setări și alege **Acces API**.
2. În **Tokenuri de acces personal**, alege **Creează token**.
3. Introdu un **Nume**, ca să știi mai târziu ce îl folosește.
4. Alege tipul de **Acces**: **Doar citire** sau **Citire și scriere**.
5. Alege când **Expiră**: **În 30 de zile**, **În 90 de zile**, **În 365 de zile** sau **Nu expiră niciodată**.
6. Alege **Creează token**.
7. În **Copiază tokenul**, copiază tokenul și păstrează-l într-un loc sigur. Aceasta este singura dată când este afișat.

Un token acționează în numele tău, în Livespace-ul în care l-ai creat, cu rolul pe care îl ai acolo în prezent. Un token cu acces **Doar citire** poate citi, dar nu poate adăuga sau modifica nimic.

Pentru a folosi un token cu un client MCP, consultă [Conectează-te cu o cheie API în loc de OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Verifică, rotește sau revocă un token

Tokenurile tale sunt afișate în **Tokenuri de acces personal**, împreună cu tipul de acces. Alege un token pentru a vedea cu ce **Începe**, ce tip de **Acces** are, când a fost **Folosit ultima dată** și când **Expiră**.

- **Pentru a înlocui un token**, alege **Rotește…**, apoi **Rotește** pentru a confirma. Un token nou îl înlocuiește, iar cel vechi nu mai funcționează imediat. Copiază noul token din **Copiază tokenul**.
- **Pentru a dezactiva un token**, alege **Revocă…**, apoi **Revocă** pentru a confirma. Orice îl folosește nu mai funcționează imediat.

Crearea, rotirea și revocarea unui token sunt înregistrate în [jurnalul de audit](/docs/teams/audit-log).

## Adaugă un webhook

Un webhook trimite evenimentele din Livespace, aceleași înregistrări ca în [jurnalul de audit](/docs/teams/audit-log), la o adresă pe care o alegi.

1. În Setări › **Acces API**, în **Webhookuri**, alege **Adaugă webhook**.
2. Introdu un **Nume** și **URL-ul**. Folosește un URL HTTPS public.
3. În **Evenimente**, lasă câmpul gol pentru toate evenimentele sau enumeră acțiuni și zone, precum `member.added` sau `sharing.*`.
4. Alege **Adaugă**.
5. În **Copiază secretul de semnare**, copiază secretul. Aceasta este singura dată când este afișat.

Dacă Dvina afișează **Această adresă nu poate fi accesată din Dvina**, folosește un URL HTTPS public.

### Verifică semnătura fiecărei cereri

Dvina trimite evenimentele în loturi, în format JSON, și semnează fiecare cerere. Folosește secretul de semnare pentru a verifica dacă o cerere provine de la Dvina:

- Fiecare cerere are un antet `X-Dvina-Signature` de forma `t=<timestamp>,v1=<signature>`.
- Semnătura este un HMAC-SHA256, în format hexazecimal, calculat folosind secretul tău de semnare pentru marcajul temporal, un punct și corpul cererii.
- Calculează semnătura și compar-o cu cea primită. Respinge o cerere dacă semnătura nu corespunde sau dacă marcajul temporal este prea vechi.

## Verifică sau modifică un webhook

Webhookurile tale sunt afișate în secțiunea **Webhookuri**, împreună cu starea lor: **Activ**, **În pauză** sau **Cu erori**. Alege unul pentru a-i vedea detaliile.

- **Pentru a-l modifica**, editează **Numele**, **URL-ul** sau **Evenimentele**, apoi alege **Salvează**.
- **Pentru a-l pune în pauză**, dezactivează **Trimite evenimente**. Reactivează opțiunea pentru a relua trimiterea.
- **Pentru a vedea cum funcționează**, verifică **Starea** și câte evenimente au fost **Trimise**. Un webhook cu erori afișează **Ultima eroare**. Dvina continuă să încerce și înregistrează eșecul în jurnalul de audit.
- **Pentru a-i schimba secretul**, alege **Secret nou de semnare…**, apoi confirmă. Solicitările sunt semnate imediat cu noul secret, așa că actualizează imediat receptorul.
- **Pentru a-l elimina**, alege **Șterge…**, apoi **Șterge** pentru a confirma. Nu i se mai trimite nimic.

## Vezi și

- [Folosește Dvina din alte aplicații cu MCP](/docs/dvina-mcp/overview)
- [Folosește jurnalul de audit](/docs/teams/audit-log)
- [Prezentare generală a echipelor](/docs/teams/overview)