# API orqali kirishdan foydalanish

> Skriptlar va MCP mijozlari uchun shaxsiy kirish tokenlarini yarating va webhook yordamida Livespace hodisalarini o‘z tizimlaringizga yuboring.

Sozlamalar › **API orqali kirish** bo‘limida shaxsiy kirish tokenlarini yaratasiz. Ular skript yoki MCP mijoziga Dvina’dan sizning nomingizdan foydalanish imkonini beradi. Administratorlar Livespace hodisalarini o‘z tizimlariga yuborish uchun shu yerda webhook ham qo‘shadilar.

API orqali kirish Enterprise tarifiga kiradi. Har bir a’zo o‘z tokenlarini yaratishi mumkin; **Webhooklar** bo‘limini faqat egalar va administratorlar ko‘radi.

## Token yaratish

1. Sozlamalarni oching va **API orqali kirish** bo‘limini tanlang.
2. **Shaxsiy kirish tokenlari** bo‘limida **Token yaratish** tugmasini tanlang.
3. Keyinchalik undan nima foydalanayotganini bilish uchun **Nomi** maydonini to‘ldiring.
4. **Kirish huquqi**ni tanlang: **Faqat o‘qish** yoki **O‘qish va yozish**.
5. **Amal qilish muddati**ni tanlang: **30 kundan keyin**, **90 kundan keyin**, **365 kundan keyin** yoki **Muddatsiz**.
6. **Token yaratish** tugmasini tanlang.
7. **Tokeningizni nusxalang** bo‘limida tokenni nusxalang va xavfsiz joyda saqlang. U faqat shu safar ko‘rsatiladi.

Token siz uni yaratgan Livespace’da sizning nomingizdan va u yerdagi joriy rolingiz bilan ishlaydi. **Faqat o‘qish** tokeni ma’lumotlarni o‘qiy oladi, lekin hech narsa qo‘sha yoki o‘zgartira olmaydi.

Tokenni MCP mijozi bilan ishlatish uchun [OAuth o‘rniga API kaliti bilan ulanish](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth) sahifasiga qarang.

## Tokenni tekshirish, almashtirish yoki bekor qilish

Tokenlaringiz **Shaxsiy kirish tokenlari** bo‘limida kirish huquqlari bilan birga ko‘rsatiladi. Tokenning **Boshlanishi**, **Kirish huquqi**, **Oxirgi foydalanish** va **Amal qilish muddati** haqidagi ma’lumotlarni ko‘rish uchun uni tanlang.

- **Tokenni almashtirish uchun** **Almashtirish…** tugmasini, so‘ng tasdiqlash uchun **Almashtirish** tugmasini tanlang. Uning o‘rniga yangi token yaratiladi va eski token darhol ishlashdan to‘xtaydi. **Tokeningizni nusxalang** bo‘limida yangi tokenni nusxalang.
- **Tokenni to‘xtatish uchun** **Bekor qilish…** tugmasini, so‘ng tasdiqlash uchun **Bekor qilish** tugmasini tanlang. Undan foydalanadigan barcha vositalar darhol ishlashdan to‘xtaydi.

Tokenni yaratish, almashtirish va bekor qilish [audit jurnalida](/docs/teams/audit-log) qayd etiladi.

## Webhook qo‘shish

Webhook Livespace hodisalarini — [audit jurnalidagi](/docs/teams/audit-log) yozuvlarning o‘zini — siz tanlagan manzilga yuboradi.

1. Sozlamalar › **API orqali kirish** sahifasidagi **Webhooklar** bo‘limida **Webhook qo‘shish** tugmasini tanlang.
2. **Nomi** va **URL** maydonlarini to‘ldiring. Internetdan ochiq kirish mumkin bo‘lgan HTTPS URL manzilidan foydalaning.
3. **Hodisalar** maydonini barcha hodisalarni olish uchun bo‘sh qoldiring yoki `member.added` yoki `sharing.*` kabi amallar va sohalarni kiriting.
4. **Qo‘shish** tugmasini tanlang.
5. **Imzolash uchun maxfiy kalitni nusxalang** bo‘limida maxfiy kalitni nusxalang. U faqat shu safar ko‘rsatiladi.

Agar Dvina **Dvina’dan bu manzilga ulanish imkonsiz** deb ko‘rsatsa, internetdan ochiq kirish mumkin bo‘lgan HTTPS URL manzilidan foydalaning.

### Har bir so‘rov imzosini tekshirish

Dvina hodisalarni JSON formatida guruhlab yuboradi va har bir so‘rovni imzolaydi. So‘rov Dvina’dan kelganini tekshirish uchun imzolash uchun maxfiy kalitdan foydalaning:

- Har bir so‘rovda `t=<timestamp>,v1=<signature>` ko‘rinishidagi `X-Dvina-Signature` sarlavhasi mavjud.
- Imzo vaqt belgisi, nuqta va so‘rov tanasidan imzolash uchun maxfiy kalitingiz yordamida hisoblangan, o‘n oltilik formatdagi HMAC-SHA256 qiymatidir.
- Uni o‘zingiz hisoblang va solishtiring. Imzosi mos kelmagan yoki vaqt belgisi juda eski bo‘lgan so‘rovni rad eting.

## Webhookni tekshirish yoki o‘zgartirish

Webhooklaringiz **Webhooklar** bo‘limida holati bilan ko‘rsatiladi: **Yoqilgan**, **To‘xtatilgan** yoki **Xatolik yuz bermoqda**. Tafsilotlarini ko‘rish uchun ulardan birini tanlang.

- **O‘zgartirish uchun**, **Nomi**, **URL** yoki **Hodisalar** maydonlarini tahrirlang, so‘ng **Saqlash**ni tanlang.
- **Vaqtincha to‘xtatish uchun**, **Hodisalarni yuborish**ni o‘chiring. Yuborishni qayta boshlash uchun uni yana yoqing.
- **Qanday ishlayotganini ko‘rish uchun**, **Holati** va nechta hodisa **Yuborilgan**ini tekshiring. Xatolik yuz berayotgan webhookda **Oxirgi xato** ko‘rsatiladi. Dvina qayta urinishda davom etadi va xatolikni audit jurnaliga yozadi.
- **Maxfiy kalitini o‘zgartirish uchun**, **Yangi imzolash kaliti…**ni tanlang, so‘ng tasdiqlang. So‘rovlar darhol yangi kalit bilan imzolanadi, shuning uchun qabul qiluvchi tomonni ham darhol yangilang.
- **O‘chirish uchun**, **O‘chirish…**ni tanlang, so‘ng tasdiqlash uchun **O‘chirish**ni tanlang. Unga boshqa hech narsa yuborilmaydi.

## Tegishli mavzular

- [MCP orqali boshqa ilovalardan Dvina’dan foydalanish](/docs/dvina-mcp/overview)
- [Audit jurnalidan foydalanish](/docs/teams/audit-log)
- [Jamoalar haqida umumiy ma’lumot](/docs/teams/overview)