# Përdorni aksesin në API

> Krijoni tokenë personalë aksesi për skripte dhe klientë MCP dhe dërgoni ngjarjet e Livespace tuaj në sistemet tuaja përmes webhook-ëve.

Te Cilësimet › **Aksesi në API**, krijoni tokenë personalë aksesi që një skript ose klient MCP të mund ta përdorë Dvina në emrin tuaj. Administratorët shtojnë aty edhe webhook-e për të dërguar ngjarjet e Livespace në sistemet e tyre.

Aksesi në API përfshihet në planin Enterprise. Çdo anëtar mund të krijojë tokenët e vet; vetëm pronarët dhe administratorët e shohin seksionin **Webhook-et**.

## Krijoni një token

1. Hapni Cilësimet dhe zgjidhni **Aksesi në API**.
2. Te **Tokenët personalë të aksesit**, zgjidhni **Krijo token**.
3. Vendosni një **Emër**, që më vonë të dini se çfarë e përdor.
4. Zgjidhni **Aksesin**: **Vetëm lexim** ose **Lexim dhe shkrim**.
5. Zgjidhni kur **Skadon**: **Pas 30 ditësh**, **Pas 90 ditësh**, **Pas 365 ditësh** ose **Nuk skadon kurrë**.
6. Zgjidhni **Krijo token**.
7. Te **Kopjoni tokenin tuaj**, kopjoni tokenin dhe ruajeni në një vend të sigurt. Ai shfaqet vetëm këtë herë.

Një token vepron në emrin tuaj, në Livespace ku e krijuat, me rolin që keni aktualisht aty. Një token me akses **Vetëm lexim** mund të lexojë, por nuk mund të shtojë ose ndryshojë asgjë.

Për të përdorur një token me një klient MCP, shihni [Lidhuni me një çelës API në vend të OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Kontrolloni, rinovoni ose revokoni një token

Tokenët tuaj renditen te **Tokenët personalë të aksesit**, së bashku me aksesin e tyre. Zgjidhni një token për të parë me çfarë **Fillon**, **Aksesin** e tij, kur është **Përdorur për herë të fundit** dhe kur **Skadon**.

- **Për të zëvendësuar një token**, zgjidhni **Rinovo…**, pastaj **Rinovo** për të konfirmuar. Një token i ri e zëvendëson dhe i vjetri ndalon së funksionuari menjëherë. Kopjoni tokenin e ri te **Kopjoni tokenin tuaj**.
- **Për të çaktivizuar një token**, zgjidhni **Revoko…**, pastaj **Revoko** për të konfirmuar. Çdo gjë që e përdor ndalon së funksionuari menjëherë.

Krijimi, rinovimi dhe revokimi i një tokeni regjistrohen në [regjistrin e auditimit](/docs/teams/audit-log).

## Shtoni një webhook

Një webhook i dërgon ngjarjet e Livespace, të njëjtat të dhëna si në [regjistrin e auditimit](/docs/teams/audit-log), në një adresë që zgjidhni ju.

1. Te Cilësimet › **Aksesi në API**, në seksionin **Webhook-et**, zgjidhni **Shto webhook**.
2. Vendosni një **Emër** dhe **URL-në**. Përdorni një URL publike HTTPS.
3. Te **Ngjarjet**, lëreni fushën bosh për të marrë çdo ngjarje, ose renditni veprime dhe fusha, si `member.added` ose `sharing.*`.
4. Zgjidhni **Shto**.
5. Te **Kopjoni sekretin e nënshkrimit**, kopjoni sekretin. Ai shfaqet vetëm këtë herë.

Nëse Dvina shfaq **Kjo adresë nuk është e arritshme nga Dvina**, përdorni një URL publike HTTPS.

### Kontrolloni nënshkrimin e çdo kërkese

Dvina i dërgon ngjarjet në grupe, në formatin JSON, dhe nënshkruan çdo kërkesë. Përdorni sekretin e nënshkrimit për të kontrolluar që një kërkesë ka ardhur nga Dvina:

- Çdo kërkesë ka një header `X-Dvina-Signature` të formës `t=<timestamp>,v1=<signature>`.
- Nënshkrimi është një HMAC-SHA256, në format heksadecimal, i vulës kohore, një pike dhe trupit të kërkesës, i krijuar me sekretin tuaj të nënshkrimit.
- Llogariteni vetë dhe krahasojeni. Refuzoni një kërkesë nëse nënshkrimi i saj nuk përputhet ose nëse vula kohore është tepër e vjetër.

## Kontrolloni ose ndryshoni një webhook

Webhook-ët tuaj renditen te **Webhook-ët** me statusin e tyre: **Aktiv**, **Në pauzë** ose **Me gabime**. Zgjidhni një për të parë hollësitë e tij.

- **Për ta ndryshuar**, ndryshoni **Emrin**, **URL-në** ose **Ngjarjet**, pastaj zgjidhni **Ruaj**.
- **Për ta pezulluar**, çaktivizoni **Dërgo ngjarje**. Aktivizojeni sërish për të rifilluar dërgimin.
- **Për të parë si po funksionon**, kontrolloni **Statusin** dhe sa ngjarje janë **Dërguar**. Një webhook me gabime shfaq **Gabimin e fundit**. Dvina vazhdon të provojë dhe e regjistron dështimin në regjistrin e auditimit.
- **Për të ndryshuar sekretin e tij**, zgjidhni **Sekret i ri nënshkrimi…**, pastaj konfirmoni. Kërkesat nënshkruhen menjëherë me sekretin e ri, ndaj përditësoni menjëherë marrësin.
- **Për ta hequr**, zgjidhni **Fshi…**, pastaj **Fshi** për të konfirmuar. Nuk i dërgohet më asgjë.

## Të ngjashme

- [Përdorni Dvina nga aplikacione të tjera me MCP](/docs/dvina-mcp/overview)
- [Përdorni regjistrin e auditimit](/docs/teams/audit-log)
- [Përmbledhje e ekipeve](/docs/teams/overview)