OsonTopshir API
Loyiha holati: Hamkor API ishga tushirilmoqda. Quyidagi shartnoma (kontrakt) yakuniy v1 ko'rinishida, lekin kalitlar hozircha faqat tanlangan hamkorlarga beriladi.

Autentifikatsiya

API so'rovlari shaxsiy kalit bilan tasdiqlanadi. Kalit sizning hisobingiz va kredit balansingizga bog'langan.

Bearer token

Kalitni har bir so'rovning Authorization sarlavhasida yuboring:

Authorization: Bearer ot_live_9d2f...
curl https://api.osontopshir.uz/partner/v1/credits \
  -H "Authorization: Bearer $OSONTOPSHIR_API_KEY"

Kalit turlari

PrefiksMaqsad
ot_live_Haqiqiy buyurtmalar. Kreditlar yechiladi.
ot_test_Sinov. Kredit yechilmaydi, hujjat o'rniga qisqa namuna fayl qaytadi.

Xavfsizlik qoidalari

  • Kalitni faqat serveringizda saqlang. Frontend, mobil ilova yoki ochiq repozitoriyga joylamang.
  • Kalit bazamizda faqat xesh ko'rinishida saqlanadi. Yo'qotilsa, tiklab bo'lmaydi, yangisi beriladi.
  • Kalit oshkor bo'lgan bo'lsa, darhol supportga yozing. Eskisi o'chiriladi.
  • Har bir kalit o'zining kreditlari bilan ishlaydi. Boshqa hamkorning buyurtmalari sizga ko'rinmaydi.

Xato javoblari

Kalit yo'q yoki noto'g'ri bo'lsa 401 qaytadi:

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "API kalit noto'g'ri yoki bekor qilingan.",
    "request_id": "req_4c1a77"
  }
}