Kaifalo Reseller API

Quick start

Barcha so'rovlar https://kaifalo.uz manziliga yuboriladi. Har bir so'rovda API kalitingizni Authorization sarlavhasida yuboring:

Authorization: Bearer YOUR_API_KEY

API kalitingiz to'g'ri ekanligini tekshirish uchun:

curl https://kaifalo.uz/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "ok": true,
  "id": 12,
  "fullname": "Your Company",
  "username": "your_tg_username",
  "balance": "1500000.00"
}

API kalitingizni hech kimga bermang. Agar kalit oshkor bo'lgan bo'lsa, uni shaxsiy kabinetingizdan (kaifalo.uz) darhol qayta yarating — eskisi o'sha zahoti bekor bo'ladi.

Conventions

• Har bir javob "ok": true yoki "ok": false maydoni bilan keladi.
• Barcha summalar so'mda (UZS), string ko'rinishida qaytariladi (masalan "11815.00") — pul aniqligini yo'qotmaslik uchun.
• Sanalar ISO 8601 formatida (2026-09-21T15:34:00).
• Sahifalash ?page=1&limit=20 parametrlari orqali (limit maksimal 100).
• Har bir buyurtma so'rovi tabiiy ravishda idempotent emas — bir xil product_id+player_id bilan ikki marta so'rov yuborilsa, ikkita alohida buyurtma yaratiladi.

Account

GET /api/v1/balance

Joriy balansingizni qaytaradi.

curl https://kaifalo.uz/api/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

{ "ok": true, "balance": "1500000.00" }

Products

GET /api/v1/products

Mavjud mahsulotlar ro'yxati (narxlar sizning hisobingiz uchun belgilangan narx bilan).

curl https://kaifalo.uz/api/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "ok": true,
  "products": [
    { "product_id": "pubg_uc_660", "name": "PUBG Mobile 660UC", "category": "PUBG Mobile UC", "price": "118148.00" },
    { "product_id": "pubg_prime_1_month", "name": "PUBG Mobile - Prime (1 Month)", "category": "PUBG Mobile Prime / Pack", "price": "11358.00" },
    { "product_id": "8_ball_pool_golden_spin", "name": "8 Ball Pool - Golden Spin", "category": "8 Ball Pool", "price": "10010.00" }
  ]
}

product_id — bu bizning o'z ID'imiz, doimiy va barqaror. U qaysi tashqi provayder orqali bajarilishini bilishingiz shart emas.

Orders

POST /api/v1/orders

Yangi buyurtma yaratadi va darhol bajaradi. Balansingizdan mahsulot narxi yechiladi.

curl -X POST https://kaifalo.uz/api/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "pubg_uc_660",
    "player_id": "5321126932"
  }'

{
  "ok": true,
  "order": {
    "id": "3f9c2e10-...-b8a1",
    "status": "COMPLETED",
    "product_id": "pubg_uc_660",
    "product_name": "PUBG Mobile 660UC",
    "player_id": "5321126932",
    "amount": "118148.00",
    "channel": "api",
    "created_at": "2026-09-21T15:40:00"
  }
}

Ba'zi mahsulotlar (masalan bir nechta maydon talab qiladigan o'yinlar) uchun extra_fields yuborish kerak bo'lishi mumkin — player_id har doim asosiy o'yinchi identifikatori sifatida avtomatik yuboriladi, extra_fields faqat QO'SHIMCHA maydonlar (masalan server ID) uchun kerak:

{
  "product_id": "some_game_offer_id",
  "player_id": "123456",
  "extra_fields": { "server_id": "2011" }
}

GET /api/v1/orders/{id}

Bitta buyurtmaning joriy holatini tekshirish.

curl https://kaifalo.uz/api/v1/orders/3f9c2e10-...-b8a1 \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /api/v1/orders

Barcha buyurtmalaringiz tarixi (sahifalangan).

curl "https://kaifalo.uz/api/v1/orders?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

HTTP status codes

Xato javoblari doim quyidagi shaklda keladi:

{ "ok": false, "error": "Odam uchun tushunarli xabar", "code": "machine_readable_code" }

Rate limits

Chegaradan oshsangiz 429 qaytadi — biroz kutib qayta urinib ko'ring.