Asosiy qismga oʻtish

2-bob · API va integratsiya

API kalitlari va autentifikatsiya

API kalit yaratish, IP roʻyxati bilan cheklash, kalitni yuborish va asosiy xato kodlari.

2 daqiqada oʻqiladi

Shu sahifada
  1. Kalit yaratish
  2. Muhim qoidalar
  3. Kalitni yuborish
  4. Asosiy soʻrovlar
  5. Autentifikatsiya xatolari

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

  1. Panelda API kalitlari boʻlimini oching.
  2. Kalitga nom bering (masalan, server yoki loyiha nomi).
  3. Xohlasangiz, Ruxsat etilgan IP maydoniga serveringiz manzillarini yozing — har qatorga bitta IP yoki CIDR (masalan, 203.0.113.10 yoki 203.0.113.0/24). Boʻsh qoldirilsa — istalgan IP.
  4. Kalit yaratish tugmasini bosing.
  5. 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.

Maqola foydali boʻldimi?

Javob topmadingizmi?

Murojaat yuboring — mutaxassis hisobingizni koʻrib, javob beradi.