Base URL: https://public-api.foxreload.com
Аутентификация
Каждый запрос передаёт заголовок `X-API-Key: YOUR_API_KEY`. Ключ выпускается в `Личный кабинет → API` и виден один раз. Для ключа можно задать IP-allowlist. HTTPS обязателен.
curl https://public-api.foxreload.com/api/products/?category_id_or_slug=steam \
-H "X-API-Key: YOUR_API_KEY" \
-H "Accept: application/json"Основные эндпоинты
| Method | Path | Description |
|---|---|---|
| GET | /api/categories/ | List categories (tree via parent_id_or_slug). |
| GET | /api/products/ | List products in a category. The product id is the itemId for orders. |
| GET | /api/products/search | Search products by query. |
| POST | /api/orders/ | Create an order by product_id (itemId). 1–10 items. |
| GET | /api/orders/{order_id} | Order status; codes in items[].externalData when completed. |
| GET | /api/orders/ | Paginated order history with status filter. |
| POST | /api/orders/{order_id}/pay | Create a payment for an order. |
| POST | /api/topups/crypto/ | Top up balance with crypto. |
Создание заказа
Заказ создаётся по `product_id` (поле `itemId`) — офферы в публичном API не используются. В одном заказе 1–10 позиций. `totalPrice` необязателен: без него берётся текущая цена товара. Если товар требует доп. данные (например, UID игрока), передайте их в `note`.
POST https://public-api.foxreload.com/api/orders/
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"items": [
{ "itemId": "product_01krgfgww8eth9xvvysd6y7r4j", "quantity": 5 }
]
}Получение кодов
Webhooks в публичном API нет — опрашивайте `GET /api/orders/{order_id}`. Когда статус становится `completed`, в каждом элементе `items[].externalData` появляются коды товаров.
GET https://public-api.foxreload.com/api/orders/{order_id}
X-API-Key: YOUR_API_KEY
{
"id": "order-uuid",
"status": "completed",
"items": [
{
"product": { "id": "product_01krg...", "name": "Steam 500 RUB" },
"quantity": 5,
"externalData": ["XXXX-YYYY-ZZZZ", "..."],
"error": null
}
]
}Надёжность
Используйте экспоненциальный backoff при сетевых ошибках и `HTTP 429`. Проверяйте статус заказа перед повторным созданием, чтобы не дублировать закуп.
Полная OpenAPI 3.1 спецификация
https://public-api.foxreload.com/openapi.json · OpenAPI 3.1 / JSON. Compatible with swagger-ui, redoc, insomnia, postman.