Do‘koningizni
Savdolar’ga ulang.

Barcha narxlar butun so‘mda (UZS). Narx botdagi do‘kon bilan bir xil; API uchun alohida ustama yo‘q. API xaridi token yaratilgan Telegram hisobining balansidan to‘lanadi. Balansni botda to‘ldiring.

Tokenni olish

@Savdolar_Robot → Start → API → Token yaratish. Qoidalarni qabul qilgach token bir marta ko‘rsatiladi. Bir hisobda bitta faol token bor; almashtirish eskisini darhol bekor qiladi.

Authorization: Bearer sav_live_…
Content-Type: application/json

Telefon tasdig‘i, hisob cheklovi, majburiy obuna va texnik tanaffus bot bilan bir xil hisobga olinadi. Bitta token uchun daqiqasiga 60 so‘rov, shundan 10 ta yozuvchi so‘rov; IP uchun 240 so‘rov. 429 javobida Retry-Afterni kuting. Bir so‘rov tanasi 16 KB dan oshmaydi.

Bir xaridning to‘liq yo‘li

1. GET /v1/services va GET /v1/products orqali katalogni oling. availableni tekshiring; aniq ombor soni oshkor qilinmaydi.
2. POST /v1/quotes bilan mahsulot uchun yangi narx taklifi oling. Bu qadam pul yechmaydi.
3. Taklif narxini xaridoringizga ko‘rsating. Bitta biznes xaridi uchun yagona Idempotency-Key yarating va so‘rov yuborishdan oldin o‘z bazangizga yozing.
4. POST /v1/orders bilan quote_idni yuboring. 202 queued — so‘rov saqlandi, xarid hali yakunlanmagan.
5. GET /v1/orders/{id}ni 5 soniya oralatib tekshiring. activation_required bo‘lsa ko‘rsatilgan hisob identifikatorini yuboring.
6. Faqat completed holatida GET /v1/orders/{id}/deliveryni chaqiring. Javobdagi matn yoki havolalarni faqat shu xaridorning shaxsiy kabinetida ko‘rsating.

POST /v1/quotes
{"product_id": 109, "quantity": 1}

POST /v1/orders
Idempotency-Key: myshop-order-42
{"quote_id": "0123456789abcdef", "customer_reference": "myshop-order-42"}

Javob shakli

{
  "ok": true,
  "data": {"amount": 150000, "currency": "UZS"},
  "request_id": "opaque-support-id"
}

Ro‘yxatlarda data massiv bo‘ladi. meta.next_cursorni keyingi sahifaning cursor maydoniga yuboring; null — oxirgi sahifa. Vaqtlar UTC Unix soniyalarda. Yangi javob maydonlarini inkor qilmang: v1 ichida qo‘shimcha maydonlar qo‘shilishi mumkin; nom yoki ma’no buzilsa yangi v2 chiqariladi.

API v1 endpointlari

OpenAPI 3.1 sxemasini olish

Sxemada barcha kirish va chiqish maydonlari, turlar, majburiy sarlavhalar hamda statuslar berilgan. POST JSON’da noma’lum maydonlar qabul qilinmaydi. customer_reference faqat o‘zingiz uchun; u idempotentlik kalitining o‘rnini bosmaydi.

Holatni to‘g‘ri talqin qiling

Balans faqat atomik rezervda yechiladi. Yetkazib beruvchi pul yechilmaganini tasdiqlasa yoki buyurtma bekor bo‘lsa, shu xaridning summasi bir marta qaytariladi. Noaniq holatda mablag‘ natija aniqlanguncha band turadi. completed keyinchalik provayder bekor qilsa cancelledga o‘tishi mumkin. Bir hisobda bir paytda faqat bitta processing/review_required xarid bo‘lishi mumkin.

Aktivatsiya yuborilgach timeout bo‘lsa, qayta yubormang. So‘rov alohida saqlanadi va holati tekshiriladi. Faqat queued buyurtmani /cancel orqali bekor qilish mumkin; poyga holatida 409 qaytishi mumkin.

Xato har doim tushunarli

{
  "ok": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "title": "Balans yetarli emas",
    "description": "Token egasining botdagi balansini to‘ldiring.",
    "details": [],
    "retryable": false
  },
  "request_id": "opaque-support-id"
}

HTTP: 400/422 noto‘g‘ri so‘rov; 401 token; 403 hisob/obuna; 402 balans; 404 resurs; 409 konflikt; 429 limit; 500/503 vaqtinchalik xato. retryable yangi xarid yaratishga ruxsat bermaydi. POST xaridda kalit va tana o‘zgarmasligi shart.

Server tomoni uchun namunalar

O‘z bazangizda xaridor buyurtmasi, Idempotency-Key, taklifning ayni JSON tanasi va biz qaytargan buyurtma IDni saqlang. Yetkazish matni turli mahsulotda turlicha bo‘lishi mumkin: API uni plain_text va alohida links ko‘rinishida beradi. HTML sifatida bajarib yubormang.