Dasturiy ta’minot ishlab chiqish · 2026-yil 14-oktabr · 2 daqiqa o‘qish
API turlari: ochiq, hamkorlik va ichki interfeyslar
Bu sahifa rus tilida: /blog/api-vidy
API’larni ikki o‘lchov bo‘yicha ajratish qulay: kim foydalana oladi va qanday texnik uslubda qurilgan. Birinchisi biznes qarori, ikkinchisi — muhandislik qarori.
Kirish bo‘yicha turlar
Ochiq (public) API
Har qanday dasturchi ro‘yxatdan o‘tib, kalit olishi va foydalanishi mumkin. Misollar: xaritalar, valyuta kurslari, ob-havo, messenjerlar bot API’lari. Kompaniyalar ochiq API orqali o‘z servisining tarqalishini kengaytiradi.
Bunday API uchun talablar yuqori: batafsil hujjatlar, barqaror versiyalar, so‘rovlar limiti, suiiste’moldan himoya.
Hamkorlik (partner) API
Faqat shartnoma asosida tanlangan hamkorlarga beriladi. Misollar: to‘lov tizimlari do‘konlar uchun, yetkazib berish xizmatlari sotuvchilar uchun, bank servislari kompaniyalar uchun. Kirish odatda alohida kalitlar, ba’zan esa IP-manzil cheklovlari bilan himoyalanadi.
Ichki (private) API
Faqat kompaniya ichida: sayt, mobil ilova, ichki CRM va ombor tizimi bir backendga murojaat qiladi. Tashqi dunyoga ochiq bo‘lmasa ham, ichki API ham hujjatlashtirilishi kerak — jamoa almashganda bu juda muhim.
Kompozit API
Bir so‘rov orqali bir nechta xizmatdan ma’lumot yig‘adigan qatlam. Masalan, mobil ilova uchun buyurtma sahifasi: buyurtma, yetkazib berish holati va bonuslar bitta javobda. Bu ilova tezligini oshiradi.
Uslub bo‘yicha turlar
| Uslub | Asosiy g‘oya | Qayerda uchraydi |
|---|---|---|
| REST | Resurslar va HTTP metodlari | Ko‘pchilik veb va mobil integratsiyalar |
| GraphQL | Mijoz kerakli maydonlarni o‘zi tanlaydi | Murakkab interfeyslar, mobil ilovalar |
| SOAP | Qat’iy XML xabarlar va rasmiy tavsif | Banklar, davlat va eski korporativ tizimlar |
| gRPC | Ixcham ikkilik format, yuqori tezlik | Ichki mikroservislar orasida |
| Vebhuklar | Server hodisa haqida o‘zi xabar beradi | To‘lovlar, bot xabarlari, holat o‘zgarishlari |
| WebSocket | Doimiy ochiq ulanish | Chat, jonli kuzatuv, birjalar |
Biznes uchun bu nima anglatadi
Tizim tanlayotganda. CRM, kassa yoki ombor dasturini tanlashdan oldin uning API turini so‘rang: ochiqmi, hujjatlari bormi, vebhuklar qo‘llab-quvvatlanadimi. API’siz tizim kelajakda «orol» bo‘lib qoladi.
O‘z servisingizni yaratayotganda. Hamkorlar bilan ishlash rejalashtirilgan bo‘lsa (masalan, dilerlar yoki agregatorlar), hamkorlik API’sini boshidan arxitekturaga qo‘ying. Keyin qo‘shish qiyinroq.
Integratsiya buyurtma qilayotganda. Ikki tizim turli uslubda ishlashi mumkin: biri SOAP, ikkinchisi REST. Bu muammo emas, lekin oraliq qatlam kerak bo‘ladi va baholashda hisobga olinishi kerak.
Har qanday API uchun umumiy talablar
- Hujjatlar: manzillar, maydonlar, misollar, xato kodlari
- Autentifikatsiya va minimal huquqlar
- Versiyalash: eski mijozlar yangilanishdan buzilmasligi uchun
- So‘rovlar limiti va suiiste’moldan himoya
- Jurnallar va monitoring
Tipik xato
Ichki API’ni «baribir faqat biz foydalanamiz» deb hujjatsiz va himoyasiz qoldirish. Mobil ilova chiqqan zahoti uning API manzillari hammaga ma’lum bo‘ladi — ilova trafigini ko‘rish qiyin emas. Shuning uchun ichki API ham tashqi kabi himoyalanishi kerak.
Vazifani muhokama qilamiz
Ism va telefon raqamingizni qoldiring — qo‘ng‘iroq qilib, jarayon haqida so‘raymiz va nimadan boshlashni taklif qilamiz.
Loyihani muhokama qilish