Skip to main content
API kalitlari /v1 Public API’ga yuborilgan so‘rovlarni autentifikatsiya qiladi. Har bir kalit xizmat hisobiga tegishli bo‘lib, shu hisobning tafsilotlar sahifasidan Developer Hub orqali yaratiladi. Maxfiy kalitni xavfsiz saqlash va almashtirish talablaringizga mos kelsa, yopiq backend integratsiyasi uchun cheklangan ruxsatli API kalitidan foydalaning. OAuth klienti yoki tokenlarni almashtirish talab etilmaydi. Agar tashkilotingiz qisqa muddatli OAuth kirish tokenlarini talab qilsa, Authentication bo‘limiga qarang.

​
Kalit tuzilishi

  • Identifier — ak_ bilan boshlanadi. Tiketlarda, jurnallarda va konfiguratsiyada havola qilish xavfsiz; o‘zi hech narsaga ruxsat bermaydi.
  • Secret — lsk_live_ bilan boshlanadi. Integratsiyangiz taqdim etadigan hisob ma’lumoti aynan shu. U yaratilganda yoki almashtirilganda bir marta ko‘rsatiladi va keyinchalik qayta olinmaydi. Kalitlar ro‘yxatida faqat oxirgi to‘rt belgi (masalan, lsk_live_…xQc4) ko‘rsatiladi, bu qatorni so‘rov yuboruvchida mavjud hisob ma’lumoti bilan solishtirish imkonini beradi.
  • Permissions — egasi bo‘lgan xizmat hisobi ruxsatlarining yaratish vaqtida tanlanadigan qismi. Kalit hech qachon o‘z hisobi ruxsat etganidan ko‘proq amal bajara olmaydi.
  • Expiration — majburiy. Har bir kalitning amal qilish muddati bor.
Maxfiy kalitlarni ko‘rsatilishi bilanoq maxfiy ma’lumotlar menejerida saqlang. Ularni hech qachon versiyalarni boshqarish tizimiga joylamang, klient tomonidagi kodga kiritmang va chatda ulashmang. Maxfiy kalit egasi kalitning ruxsatlari bilan harakat qila oladi.

​
Kalit yaratish

Xizmat hisobining tafsilotlar sahifasida kalit to‘rt bosqichda yaratiladi: unga nom bering, aynan shu kalit uchun zarur ruxsatlarni tanlang, amal qilish muddatini belgilang — 30, 90 yoki 365 kun, yoki bir yilgacha bo‘lgan maxsus muddat — va ma’lumotlarni ko‘rib chiqing. Maxfiy kalit yakunlanganda bir marta ko‘rsatiladi. Hisob ko‘proq ruxsat bersa ham, har bir kalitni so‘rov yuboruvchiga zarur bo‘lgan eng tor ruxsatlar to‘plami bilan cheklang. Kalit sizib chiqsa, uning ruxsatlari zarar ko‘lamini belgilaydi.

​
Uzilishsiz almashtirish

Almashtirish yangi maxfiy kalit chiqaradi va kesishish oynasini — 1 soat, 24 soat yoki 7 kun — boshlaydi; bu vaqt davomida eski maxfiy kalit ishlashda davom etadi. Bu yangi maxfiy kalitni o‘z tezligingizda joylashtirishlaringizga tatbiq etish imkonini beradi:
1

Kalitni almashtiring

Eng sekin joylashtirish yo‘lingizni qamrab oladigan kesishish oynasini tanlang. Yangi maxfiy kalit bir marta ko‘rsatiladi — uni darhol saqlang.
2

Integratsiyalaringizni yangilang

Eski maxfiy kalitni u sozlangan barcha joylarda almashtiring. Oyna tugaguncha kalit holati kesishish jarayonida ekani ko‘rsatiladi.
3

Oyna yopilishidan oldin tekshiring

Trafik yangi maxfiy kalitga o‘tganini tasdiqlash uchun so‘rovlar jurnallaridan foydalaning. Kesishish tugagach, eski maxfiy kalit autentifikatsiyadan o‘tmay qoladi.
Kalitni muddati tugashidan oldin ham almashtiring: amal qilish muddati yaqinlashayotgan kalitlar kalitlar ro‘yxatida muddati tugayotgan deb belgilanadi. Muddati tugagan kalit autentifikatsiyadan o‘tmaydi — u bilan yuborilgan so‘rovlar credential_expired kodli 401 qaytaradi.

​
Darhol bekor qilish

Bekor qilish darhol kuchga kiradi va qaytarib bo‘lmaydi — kesishish oynasi ham, bekor qilishni ortga qaytarish ham yo‘q. Maxfiy kalit oshkor bo‘lgan deb gumon qilsangiz, kalitni zudlik bilan bekor qiling; sog‘lom hisob ma’lumotini almashtirayotgan bo‘lsangiz, bekor qilish o‘rniga almashtirishdan foydalaning. Bekor qilingan kalit bilan yuborilgan so‘rovlar credential_revoked kodli 401 qaytaradi. Agar integratsiya egalik qiladigan barcha kalitlarni bir vaqtda to‘xtatish kerak bo‘lsa, buning o‘rniga uning xizmat hisobini o‘chiring.