Dvina MCP

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.

Markdown formatında bax

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 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 qeydə alınır.

Webhook əlavə edin

Webhook Livespace-in hadisələrini — audit jurnalındakı 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.