Reseller API

Покупка ключей с вашего баланса из своего бота или магазина. Цены, наличие и баланс — те же, что в Telegram-боте.

Начало работы

Authorization: Bearer rk_ваш_ключ

Формат совместим с reseller API хабов: те же методы, поля и коды ошибок. Если ваш бот уже работал с таким API, достаточно поменять адрес и ключ.

GET/v1/account

Ваш логин и баланс.

curl "https://api.thomas-service.pro/v1/account" -H "Authorization: Bearer $API_KEY"

{
  "ok": true,
  "account": {"login": "seller", "balance_usd": "25.00", "api_key_prefix": "rk_AbCdEf…"}
}

GET/v1/products

Товары, ваши цены и сколько ключей можно купить сейчас. Для покупки используйте product_id.

curl "https://api.thomas-service.pro/v1/products" -H "Authorization: Bearer $API_KEY"

{
  "ok": true,
  "products": [{
    "product_id": 100001,
    "category": {"id": 1, "name": "PUBG Mobile · Android без root"},
    "position": {"id": 100001, "name": "ZOLO", "status": ""},
    "name": "Zolo 1Day",
    "price_usd": "0.55",
    "stock": 46
  }]
}

Список меняется: товары появляются и снимаются, цены и наличие обновляются. Перед продажей сверяйтесь с ним, номера товаров постоянные.

POST/v1/purchases

Покупка: списывает стоимость с баланса и возвращает ключи прямо в ответе. Заголовок Idempotency-Key обязателен — это ваш номер заказа (1–64 символа: A–Z a–z 0–9 _ - : ., хотя бы одна буква или цифра).

curl -X POST "https://api.thomas-service.pro/v1/purchases" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-12345678" \
  -d '{"product_id": 100001, "quantity": 1}'

201 Created — покупка выполнена:

{
  "ok": true,
  "purchase": {
    "client_order_id": "order-12345678",
    "order_id": 42,
    "product_id": 100001,
    "name": "ZOLO — Zolo 1Day",
    "quantity": 1,
    "unit_price_usd": "0.55",
    "total_price_usd": "0.55",
    "balance_usd": "24.45",
    "keys": ["PRODUCT-KEY"],
    "instruction_url": null
  }
}

GET/v1/purchases/{idempotency_key}

Повторно получить заказ: тот же ответ, что у покупки. 404 purchase_not_found — заказа с таким ключом не было, его можно создать.

curl "https://api.thomas-service.pro/v1/purchases/order-12345678" -H "Authorization: Bearer $API_KEY"

Ошибки

При ошибке: {"ok": false, "error": {"code": "…", "message": "…"}, "request_id": "…"}