HamkorlikПартнёрскийPartner API

Buyurtma berilganda quyidagi bosqichlar bitta so'rovda bajariladi:При создании заказа шаги выполняются в одном запросе:When an order is placed, these steps run in one request:

Har bir so'rovda key parametri majburiy.В каждом запросе параметр key обязателен.Every request requires the key parameter.

Uch xil xizmat bor. add da ishlashi farq qiladi:Три вида услуг. Поведение в add отличается:Three service types. Behavior in add differs:

Xato bo'lsa javob doim shunday (error kaliti bilan):При ошибке ответ всегда такой (с ключом error):On error, response always looks like this:

{ "error": "Invalid API key" }

Hisobingizdagi joriy balansni qaytaradi.Возвращает текущий баланс.Returns your current balance.

So'rovЗапросRequest

JavobОтветResponse

{
  "balance": 152400,
  "currency": "UZS"
}

Yoqilgan xizmatlar ro'yxati. service ID'ni add da ishlatasiz.Список активных услуг. ID используется в add.List of enabled services. Use service ID in add.

So'rovЗапросRequest

Javob (massiv)Ответ (массив)Response (array)

[
  {
    "service": 1,  "name": "Telegram Premium 3 oy",
    "type": "premium",  "rate": 45000,  "min": 1,  "max": 1,  "currency": "UZS"
  },
  {
    "service": 4,  "name": "Telegram Stars",
    "type": "stars",  "rate": 220,  "min": 50,  "max": 2000,  "currency": "UZS"
  },
  {
    "service": "5170233102089322756",  "name": "Yurakcha 🎁",
    "type": "gift",  "rate": 25000,  "comment_per_char": 5,  "currency": "UZS"
  }
]

MaydonlarПоляFields

Yangi buyurtma yaratadi va bajaradi. Balans darhol yechiladi; xato bo'lsa qaytariladi.Создаёт и выполняет заказ. Баланс списывается сразу; при ошибке возвращается.Creates and executes an order. Balance charged immediately; auto-refunded on error.

ParametrlarПараметрыParameters

So'rov — PremiumЗапрос — PremiumRequest — Premium

So'rov — StarsЗапрос — StarsRequest — Stars

So'rov — GiftЗапрос — GiftRequest — Gift

Muvaffaqiyatli javobУспешный ответSuccess response

{ "order": 1042 }

Bitta buyurtma holatini qaytaradi.Возвращает статус одного заказа.Returns the status of a single order.

ParametrlarПараметрыParameters

So'rovЗапросRequest

Javob — Premium/StarsОтвет — Premium/StarsResponse — Premium/Stars

{
  "order": 1042,  "status": "Completed",
  "charge": 45000,  "currency": "UZS",
  "quantity": 1,  "type": "premium",  "link": "@username"
}

Javob — GiftОтвет — GiftResponse — Gift

{
  "order": 1050,  "status": "Completed",
  "charge": 25060,  "currency": "UZS",
  "type": "gift",  "link": "username",
  "gift": "5170233102089322756",  "anonymous": 1,  "message": "Tabriklayman"
}

Bir nechta buyurtma holati bitta so'rovda. ID'lar vergul bilan (maks. 100).Статус нескольких заказов за один запрос. ID через запятую (макс. 100).Status of multiple orders in one request. IDs comma-separated (max 100).

ParametrlarПараметрыParameters

So'rovЗапросRequest

JavobОтветResponse

{
  "1042": { "status": "Completed", "charge": 45000, "currency": "UZS" },
  "1043": { "status": "Refunded", "charge": 22000, "currency": "UZS" },
  "1044": { "error": "Incorrect order ID" }
}