# API girişindən istifadə edin

> Skriptlər və MCP müştəriləri üçün şəxsi giriş tokenləri yaradın və webhook-larla Livespace-inizin hadisələrini öz sistemlərinizə göndərin.

Parametrlər › **API girişi** bölməsində şəxsi giriş tokenləri yarada bilərsiniz. Bu tokenlər skriptin və ya MCP müştərisinin Dvina-dan sizin adınızdan istifadə etməsinə imkan verir. Administratorlar Livespace-in hadisələrini öz sistemlərinə göndərmək üçün həmin bölmədə webhook-lar da əlavə edirlər.

API girişi Enterprise planına daxildir. Hər bir üzv öz tokenlərini yarada bilər; **Webhook-lar** bölməsini yalnız sahiblər və administratorlar görür.

## Token yaradın

1. Parametrləri açın və **API girişi** seçin.
2. **Şəxsi giriş tokenləri** bölməsində **Token yarat** seçin.
3. Tokenin nə üçün istifadə olunduğunu sonradan bilmək üçün **Ad** daxil edin.
4. **İcazə** seçin: **Yalnız oxuma** və ya **Oxuma və yazma**.
5. **Etibarlılıq müddəti** seçin: **30 gün**, **90 gün**, **365 gün** və ya **Müddətsiz**.
6. **Token yarat** seçin.
7. **Tokeninizi kopyalayın** bölməsində tokeni kopyalayın və təhlükəsiz yerdə saxlayın. Token yalnız bu dəfə göstərilir.

Token onu yaratdığınız Livespace-də, oradakı cari rolunuzla sizin adınızdan işləyir. **Yalnız oxuma** tokeni məlumatları oxuya bilər, lakin heç nə əlavə edə və ya dəyişə bilməz.

Tokeni MCP müştərisi ilə istifadə etmək üçün [OAuth əvəzinə API açarı ilə qoşulun](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth) səhifəsinə baxın.

## Tokeni yoxlayın, yeniləyin və ya ləğv edin

Tokenləriniz **Şəxsi giriş tokenləri** bölməsində icazələri ilə birlikdə göstərilir. Tokenin **Başlanğıcı**, **İcazə**, **Son istifadə vaxtı** və **Etibarlılıq müddəti** məlumatlarını görmək üçün onu seçin.

- **Tokeni əvəz etmək üçün** **Yenilə…**, sonra təsdiqləmək üçün **Yenilə** seçin. Onu yeni token əvəz edir və köhnə token dərhal işləməyi dayandırır. Yeni tokeni **Tokeninizi kopyalayın** bölməsində kopyalayın.
- **Tokeni dayandırmaq üçün** **Ləğv et…**, sonra təsdiqləmək üçün **Ləğv et** seçin. Ondan istifadə edən hər şey dərhal işləməyi dayandırır.

Tokenin yaradılması, yenilənməsi və ləğv edilməsi [audit jurnalında](/docs/teams/audit-log) qeydə alınır.

## Webhook əlavə edin

Webhook Livespace-in hadisələrini — [audit jurnalındakı](/docs/teams/audit-log) qeydlərlə eyni qeydləri — seçdiyiniz ünvana göndərir.

1. Parametrlər › **API girişi** bölməsində, **Webhook-lar** altında **Webhook əlavə et** seçin.
2. **Ad** və **URL** daxil edin. İctimaiyyətə açıq HTTPS URL-dən istifadə edin.
3. **Hadisələr** bölməsini bütün hadisələr üçün boş saxlayın və ya `member.added` və ya `sharing.*` kimi əməliyyatları və sahələri sadalayın.
4. **Əlavə et** seçin.
5. **İmzalama sirrini kopyalayın** bölməsində sirri kopyalayın. Sirr yalnız bu dəfə göstərilir.

Dvina **Dvina bu ünvana çata bilmir** bildirirsə, ictimaiyyətə açıq HTTPS URL-dən istifadə edin.

### Hər sorğunun imzasını yoxlayın

Dvina hadisələri paketlər şəklində, JSON formatında göndərir və hər sorğunu imzalayır. Sorğunun Dvina-dan gəldiyini yoxlamaq üçün imzalama sirrindən istifadə edin:

- Hər sorğuda `t=<timestamp>,v1=<signature>` şəklində `X-Dvina-Signature` başlığı var.
- İmza vaxt möhürü, nöqtə və sorğunun gövdəsindən imzalama sirrinizlə yaradılmış, onaltılıq formatda HMAC-SHA256 dəyəridir.
- Bu dəyəri özünüz hesablayın və müqayisə edin. İmzası uyğun gəlməyən və ya vaxt möhürü çox köhnə olan sorğunu rədd edin.

## Webhook-u yoxlayın və ya dəyişdirin

Webhook-larınız **Webhook-lar** bölməsində statusları ilə birlikdə göstərilir: **Aktiv**, **Dayandırılıb** və ya **Xəta verir**. Təfərrüatlarına baxmaq üçün birini seçin.

- **Dəyişdirmək üçün** onun **Ad**, **URL** və ya **Hadisələr** sahələrini redaktə edin, sonra **Yadda saxla** seçin.
- **Dayandırmaq üçün** **Hadisələri göndər** seçimini söndürün. Göndərməni bərpa etmək üçün onu yenidən aktivləşdirin.
- **Necə işlədiyini görmək üçün** onun **Status** göstəricisini və **Göndərilib** göstəricisindəki hadisə sayını yoxlayın. Xəta verən webhook-da **Son xəta** göstərilir. Dvina cəhdləri davam etdirir və xətanı audit jurnalında qeydə alır.
- **Gizli açarını dəyişdirmək üçün** **Yeni gizli imzalama açarı…** seçin, sonra təsdiqləyin. Sorğular dərhal yeni açarla imzalanır, buna görə də qəbuledicini dərhal yeniləyin.
- **Silmək üçün** **Sil…** seçin, sonra təsdiqləmək üçün **Sil** seçin. Bundan sonra ona heç nə göndərilmir.

## Əlaqəli mövzular

- [Dvina-nı MCP vasitəsilə digər tətbiqlərdən istifadə edin](/docs/dvina-mcp/overview)
- [Audit jurnalından istifadə edin](/docs/teams/audit-log)
- [Komandalara ümumi baxış](/docs/teams/overview)