API nima: oddiy tilda tushuntirish va AI ovozli operatorga API orqali ariza yuborish
Sado AI jamoasi · · 3 daqiqada o‘qiladi
Qisqacha
API (inglizcha Application Programming Interface, ya’ni dasturiy interfeys) — bir dastur boshqa dasturdan ish so‘rashi yoki ma’lumot olishi uchun kelishilgan qoidalar: qaysi manzilga, qanday so‘rov yuborish va qanday javob olish. Saytdagi Click yoki Payme to‘lovi, saytdagi xarita, Telegram botlar — hammasi API orqali ishlaydi. AI ovozli operatorda API orqali sizning tizimingiz yangi arizani yuboradi, operator unga darhol qo‘ng‘iroq qiladi, qo‘ng‘iroq natijasi esa tizimingizga qaytadi.
API oddiy tilda
Restoranda siz oshxonaga kirmaysiz: ofitsiantga menyudagi taomni aytasiz, u buyurtmani oshpazga yetkazadi va taomni olib keladi. API — mana shu ofitsiant. Bir dastur ikkinchisining ichiga kirmaydi, faqat kelishilgan tartibda so‘raydi va javob oladi.
- Internet-do‘kon to‘lov tizimiga: «Shu buyurtma uchun 250 000 so‘m to‘lov oching».
- Yetkazib berish xizmati xarita servisiga: «Shu ikki manzil orasi necha kilometr?»
- Telegram bot Telegram’ga: «Shu odamga mana bu xabarni yubor».
API so‘rovi nimalardan iborat
| Qism | Nima | Misol |
|---|---|---|
| Manzil | So‘rov qayerga boradi | Arizalar qabul qilinadigan manzil |
| Kalit | Kim so‘rayotganini tasdiqlaydi | Portalda olingan maxfiy API kaliti |
| So‘rov | Nima yuborilyapti | Ism, telefon, kurs, nega qo‘ng‘iroq qilish mumkin |
| Javob | Nima qaytdi | «Qabul qilindi» yoki xato sababi |
API so‘ragan paytingizda ishlaydi. Voqea bo‘lganda tizim sizga o‘zi xabar yuborishi esa webhook deyiladi: webhook nima.
Misol: Toshkentdagi o‘quv markazi
«Bilim Plus» (nomi o‘ylab topilgan) ingliz tili va matematika kurslarini o‘tadi. Saytdagi ro‘yxatdan o‘tish formasi markazning o‘z dasturiga tushadi. Ilgari arizalar bir-ikki kun kutib qolardi, endi shunday ishlaydi:
- Ota-ona saytda forma to‘ldiradi: farzandining ismi, yoshi, qaysi kurs.
- Markaz dasturi bir zumda API orqali Sado’ga yuboradi: ism, telefon, kurs va qo‘ng‘iroq asosi — «saytdagi ariza».
- AI operator darhol qo‘ng‘iroq qiladi va bepul sinov darsiga yozadi.
- Qo‘ng‘iroq natijasi markaz dasturiga qaytadi, administrator kimni qachon kutishni ko‘radi.
Sado: Assalomu alaykum, Bilim Plus o‘quv markazidan Malika. Hozir saytda ingliz tiliga ariza qoldirgandingiz, shunga qo‘ng‘iroq qildim.
Mijoz: Ha, o‘g‘lim uchun. O‘n ikki yoshda, boshlang‘ich darajada.
Sado: Tushunarli. Avval bepul sinov darsi bo‘ladi, darajasini ham aniqlaymiz. Shanba soat o‘nga yoki yakshanba soat ikkiga kelolasizlarmi?
Mijoz: Shanba o‘nga kelamiz.
Sado: Xo‘p, shanba soat o‘nga yozib qo‘ydim. Juma kuni eslatib qo‘ng‘iroq qilamiz.
Qo‘ng‘iroq qanday eshitiladi:
AI ovozli operatorda API nima uchun kerak
- Ariza yuborish: sizning tizimingizga tushgan har bir arizaga operator darhol qo‘ng‘iroq qiladi (chiquvchi qo‘ng‘iroqlar).
- Natijani olish: qo‘ng‘iroqlar, xulosa, keyingi qadam sizning dasturingizga qaytadi.
- Narx va qoldiq: katalogni API orqali yangilab turasiz, operator qo‘ng‘iroqda faqat katalogdagi narxni aytadi.
- API shart bo‘lmagan holatlar: Bitrix24 bilan tayyor ulanish bor, Excel ro‘yxatni portalga o‘zingiz yuklaysiz (Excel va Google Sheets), amoCRM va 1C’ni jamoamiz ulaydi.
O‘quv markazlari uchun boshqa misollar: ta’lim markazlari uchun AI operator. Texnik tafsilotlar: dasturchilar uchun.
API ulashdan oldin tekshiruv ro‘yxati
- API kalitini faqat dasturchiga bering, chatga yoki kodning ochiq qismiga yozmang.
- Har bir arizaga o‘z raqamini bering: xuddi o‘sha ariza qayta yuborilsa, ikkinchi ariza ochilmaydi.
- Har bir odam uchun qo‘ng‘iroq asosini yozing: ariza qoldirgan, rozilik bergan yoki mijozingiz. O‘zbekistonda shaxsiy ma’lumotlar haqida qonun bor.
- Qo‘ng‘iroq soatlarini va kunlik chegarani portalda belgilang.
- Avval bitta test arizani yuborib, qo‘ng‘iroq va natijani tekshiring.
Faqat gaplashilgan daqiqa uchun to‘laysiz: daqiqasi 800 so‘m. Jonli sinab ko‘ring yoki 78 778 01 23 ga qo‘ng‘iroq qiling. Boshqa savollar: Sado haqida savollar.
Savollar
API ishlatish uchun dasturchi kerakmi?
Ha, o‘z tizimingizni API’ga ulash uchun dasturchi kerak. Agar Bitrix24 yoki Excel ishlatsangiz, API shart emas: Sado’da tayyor yo‘llar bor, sozlashni jamoamiz qiladi.
API kaliti nima?
Bu maxfiy parol kabi satr: u so‘rov sizning kompaniyangizdan kelganini tasdiqlaydi. Sado’da kalit portal sozlamalarida yaratiladi va faqat bir marta ko‘rsatiladi.
API va webhook farqi nima?
API’da sizning dasturingiz so‘raydi va javob oladi. Webhook’da tizim voqea bo‘lganda sizga o‘zi xabar yuboradi. Odatda ikkalasi birga ishlatiladi.