Asosiy qismga o'tish

API metodlari · 6-bob

Takliflar

Taklif — sotishingiz mumkin bo'lgan bitta mahsulot, masalan PUBG Mobile uchun "660 UC", o'z narxingiz bilan. Katalogingizni qurish va uni yangilab turish uchun shu so'rovlardan foydalaning.

1 daqiqa o'qish

Takliflar ro'yxati

GET/offers

Parametr Tavsif
category Faqat shu turkumdagi takliflar, masalan games.
search Mahsulot va taklif nomlari bo'yicha qidiruv.
in_stock true (sukut bo'yicha) yoki false.
updated_since ISO 8601 vaqt. Shu vaqtdan keyin o'zgargan takliflarni qaytaradi, jumladan sotuvdan chiqib ketganlarini ham — in_stock hisobga olinmaydi.
page Sahifa raqami, 1 dan boshlab.
per_page Bir sahifadagi elementlar soni, 500 tagacha (sukut bo'yicha 100).
curl "https://partner.goxost.net/api/v1/offers?category=games&per_page=100" \
  -H "Authorization: Bearer $PARTNER_API_KEY"
{
  "data": [{
    "id": 1042,
    "sku": "GX-1042",
    "product": { "id": 12, "slug": "pubg-mobile", "name": "PUBG Mobile", "category": "games", "region": "Global", "image_url": "https://…" },
    "name": "660 UC",
    "price": "9.63",
    "currency": "USD",
    "in_stock": true,
    "delivery": "player_topup",
    "fields": [
      { "key": "player_id", "label": "Player ID", "required": true },
      { "key": "server_id", "label": "Server", "required": false, "options": ["…"] }
    ],
    "updated_at": "2026-11-15T09:30:00Z"
  }],
  "meta": { "page": 1, "per_page": 100, "total": 1, "last_page": 1 }
}

Bitta taklifni olish

GET/offers/{id}

Bitta taklifni xuddi shu ko'rinishda data ichida qaytaradi. Noma'lum id uchun 404 NOT_FOUND qaytadi. Narx va mavjudlik hozirgi ekaniga ishonch hosil qilish uchun to'lov sahifasini ko'rsatishdan oldin shu so'rovni yuboring.

Taklif maydonlari

Maydon Tavsif
id Taklif ID si. O'zgarmaydi — buyurtmalarda uni offer_id sifatida ishlating.
sku Bizning mahsulot kodimiz, GX-….
product Taklif tegishli bo'lgan o'yin yoki xizmat.
name Taklif nomi, masalan 660 UC.
price Bir dona uchun yakuniy narxingiz.
in_stock false bo'lsa, hozir buyurtma berib bo'lmaydi.
delivery player_topup — to'g'ridan-to'g'ri o'yinchi hisobiga tushadi; code — vaucher kodi buyurtmaning delivered maydonida qaytadi.
fields Buyurtmaning fields obyektida nima yuborish kerakligi, key bo'yicha. options bo'lsa, ulardan birini yuboring.
updated_at Taklif oxirgi marta o'zgargan vaqt.

Mahalliy nusxani yangilab turish

  1. To'liq katalogni bir marta, sahifama-sahifa yuklang.
  2. Har bir necha daqiqada GET /offers?updated_since=<time of last sync> so'rovini yuboring va o'zgargan takliflarni, jumladan in_stock va price ni yangilang.
  3. To'lovdan oldin taklifni GET /offers/{id} bilan qayta o'qing yoki buyurtma bilan max_price yuboring.