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
| Prefiks | Maqsad |
|---|---|
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"
}
}