API kalitlari va autentifikatsiya
API kalit yaratish, IP roʻyxati bilan cheklash, kalitni yuborish va asosiy xato kodlari.
API doʻkoningiz yoki botingizdan buyurtmalarni avtomatik berish uchun kerak. Toʻliq hujjat panelning API hujjati boʻlimida va https://partner.goxost.net/docs sahifasida.
Kalit yaratish
- Panelda API kalitlari boʻlimini oching.
- Kalitga nom bering (masalan, server yoki loyiha nomi).
- Xohlasangiz, Ruxsat etilgan IP maydoniga serveringiz manzillarini yozing — har qatorga bitta IP yoki CIDR (masalan,
203.0.113.10yoki203.0.113.0/24). Boʻsh qoldirilsa — istalgan IP. - Kalit yaratish tugmasini bosing.
- Toʻliq kalit (
gxp_…) faqat bir marta koʻrsatiladi. Nusxa oling va server sozlamalarida xavfsiz saqlang.
Bizda kalitning faqat xeshi saqlanadi — yoʻqolgan kalitni tiklab boʻlmaydi, yangisini yarating.
Muhim qoidalar
- Bir vaqtda koʻpi bilan 10 ta faol kalit boʻlishi mumkin.
- Kalitni hozir yaratish mumkin, lekin API hisob tasdiqlangach ishlaydi.
- Kalitni faqat serverda saqlang — brauzer sahifasi, mobil ilova yoki ochiq repozitoriyga qoʻymang.
- Kalit sizib chiqsa, uni Oʻchirish tugmasi bilan oʻchiring — u bilan yuborilgan soʻrovlar darhol toʻxtaydi. Keyin yangisini yarating.
- Har bir ishchi kalit uchun IP roʻyxatini yoqish tavsiya etiladi.
Kalitni yuborish
Asosiy manzil: https://partner.goxost.net/api/v1. Barcha soʻrovlar HTTPS orqali. Kalitni ikki sarlavhadan birida yuboring:
Authorization: Bearer gxp_XXXXXXXX
X-Api-Key: gxp_XXXXXXXX
Ulanishni tekshirish:
curl https://partner.goxost.net/api/v1/balance \
-H "Authorization: Bearer $PARTNER_API_KEY"
Asosiy soʻrovlar
| Soʻrov | Vazifasi |
|---|---|
GET /balance |
Balans va joriy tarif |
GET /offers |
Takliflar katalogi |
GET /offers/{id} |
Bitta taklif |
POST /offers/{id}/check |
Oʻyinchini oldindan tekshirish |
POST /orders |
Buyurtma berish |
GET /orders/{transaction_id} |
Buyurtma holati |
GET /orders |
Buyurtmalar roʻyxati |
transaction_id — sizning noyob buyurtma raqamingiz. Tarmoq xatosidan keyin xuddi shu soʻrovni shu transaction_id bilan qayta yuborsangiz, pul ikki marta yechilmaydi.
Autentifikatsiya xatolari
| Kod | HTTP | Sabab |
|---|---|---|
UNAUTHENTICATED |
401 | Kalit yoʻq yoki notoʻgʻri |
IP_NOT_ALLOWED |
403 | Soʻrov kalitning IP roʻyxatida boʻlmagan manzildan keldi |
ACCOUNT_NOT_ACTIVE |
403 | Hisob hali tasdiqlanmagan yoki toʻxtatilgan |
RATE_LIMITED |
429 | Soʻrovlar juda koʻp — Retry-After soniya kuting |
Har bir javobda X-RateLimit-Limit va X-RateLimit-Remaining sarlavhalari bor. Limit hisobning barcha kalitlari uchun umumiy. Barcha xato kodlari roʻyxati API hujjatining «Xatolar va cheklovlar» bobida.