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
- To'liq katalogni bir marta, sahifama-sahifa yuklang.
- Har bir necha daqiqada
GET /offers?updated_since=<time of last sync>so'rovini yuboring va o'zgargan takliflarni, jumladanin_stockvapriceni yangilang. - To'lovdan oldin taklifni
GET /offers/{id}bilan qayta o'qing yoki buyurtma bilanmax_priceyuboring.