API oddiy so‘zlar bilan: dasturlar bir-biri bilan qanday ma’lumot almashadi

API (Application Programming Interface) — dasturlash interfeysi. Oddiy qilib aytganda, bu bir dastur boshqasidan ma’lumot so‘rashi yoki unga buyruq berishi uchun kelishilgan qoidalar to‘plami. Odamlar dasturdan tugma va ekranlar orqali foydalanadi, dasturlar esa bir-biridan API orqali foydalanadi.

Restoran misoli

Restoranda mijoz oshxonaga kirib, oshpazga buyurtma bermaydi. U menyuni ko‘radi va ofitsiantga aytadi. Ofitsiant buyurtmani oshxonaga yetkazadi va taomni olib keladi. Bu yerda:

• menyu — API hujjatlari: nima so‘rash mumkin va qanday;
• ofitsiant — API: so‘rovni qabul qilib, javobni qaytaradi;
• oshxona — boshqa tizim, uning ichki ishi sizga ko‘rinmaydi.

Siz oshxona qanday ishlashini bilishingiz shart emas — menyudagi qoidalarga amal qilish kifoya.

So‘rov va javob

API bilan ishlash odatda shunday:

1. Dastur buyurtma raqamini ko‘rsatib so‘rov yuboradi: «shu buyurtmaning holati qanday?»
2. API so‘rovni tekshiradi: so‘rovchi kim, ruxsati bormi
3. Tizim ma’lumotni topadi
4. API javob qaytaradi: «Holat — yo‘lda, kuryer — Anvar»

Javob odatda dasturlar oson o‘qiydigan formatda — ko‘pincha JSON.

Kundalik misollar

• Onlayn to‘lov. Sayt to‘lov tizimining API’siga to‘lov yaratish so‘rovini yuboradi va to‘lov o‘tganini API orqali biladi.
• Telegram-bot. Bot Telegram Bot API orqali xabarlarni oladi va yuboradi.
• Valyuta kurslari. Hisob tizimi kurslarni bank yoki rasmiy manba API’sidan oladi.
• Xaritalar. Sayt manzilni xarita servisi API’si orqali ko‘rsatadi.
• Marketpleys. Sotuvchining hisob tizimi qoldiqlarni marketpleys API’siga yuboradi.

API turlari

• Ochiq (ommaviy) API — tashqi dasturchilar uchun, ko‘pincha ro‘yxatdan o‘tish va kalit bilan
• Hamkorlik API — faqat shartnoma asosida hamkorlar uchun
• Ichki API — kompaniyaning o‘z tizimlari o‘rtasida

Texnik uslublar ham farq qiladi: REST, GraphQL, SOAP va boshqalar. Biznes uchun bu tafsilotlar emas, API nimani qila olishi muhim.

Kalitlar va xavfsizlik

Ko‘p API’lar kirish uchun kalit yoki token talab qiladi — bu dastur uchun parol. U kim so‘rov yuborayotganini aniqlaydi va nimaga ruxsat berilganini cheklaydi. Kalitlar maxfiy saqlanadi va oshkor bo‘lsa, almashtiriladi.

Biznes uchun API nima beradi

• Tizimlar o‘rtasida ma’lumotlarni qo‘lda ko‘chirish yo‘qoladi
• Mijoz uchun jarayonlar tezlashadi: to‘lov, holat, yozilish
• Yangi kanallarni ulash osonlashadi: bot, mobil ilova, marketpleys
• Hamkorlar bilan avtomatik ma’lumot almashish

Tizim tanlashda nimani so‘rash kerak

CRM, hisob tizimi yoki boshqa servis tanlaganda so‘rang:

1. API bormi va u nimani qila oladi: faqat o‘qishmi yoki yozish ham
2. Hujjatlar ochiqmi va tushunarli
3. Foydalanish uchun cheklovlar bormi — so‘rovlar soni, qo‘shimcha shartlar
4. Hodisalar haqida o‘zi xabar bera oladimi (vebhuklar)

API’si yo‘q tizim kelajakda boshqa tizimlar bilan bog‘lashda katta to‘siq bo‘ladi. Shuning uchun bu savol funksiyalar ro‘yxati kabi muhim.