FoxReload API: быстрый старт 2026 — первый запрос за 10 минут
Этот быстрый старт FoxReload API написан для бэкенд-разработчиков и инженеров закупок, которым нужно интегрировать оптовый каталог цифровых товаров в свой витринный сайт, ERP или внутренние инструменты. К концу статьи вы сделаете реальный авторизованный запрос к https://api.foxreload.com/v1/catalog и разберёте JSON-ответ.
1. Получите API-ключ
После одобрения вашего дистрибьюторского аккаунта (KYC + первый депозит) откройте дашборд FoxReload, перейдите в Settings → API и сгенерируйте пару ключей: client_id и client_secret. Ключи привязаны к окружению — используйте ключи с префиксом test_ для песочницы и live_ для production. Каждый ключ можно ограничить IP-аллоулистом (рекомендуется CIDR /32).
Никогда не коммитьте ключи в git. Храните их в секрет-менеджере (AWS Secrets Manager, Doppler, Vault) и инжектите в рантайме.
2. Заголовок авторизации
FoxReload использует bearer-token авторизацию. Каждый запрос должен содержать:
Authorization: Bearer {client_secret}
X-Client-Id: {client_id}
Accept: application/json
Запросы без обоих заголовков возвращают HTTP 401 unauthorized. Запросы по plain HTTP отбрасываются на edge — принимается только TLS 1.2+.
3. Первый curl
Самая простая read-эндпоинт — GET /v1/catalog, возвращает SKU, доступные вашему аккаунту, с учётом ваших контрактных регионов и платёжных рельсов.
curl -X GET "https://api.foxreload.com/v1/catalog?region=TR&category=gift_card&limit=50" \
-H "Authorization: Bearer live_sk_9f2a..." \
-H "X-Client-Id: cid_8e1c..." \
-H "Accept: application/json"
Успешный вызов возвращает HTTP 200 с пагинированным payload'ом:
{
"data": [
{
"sku": "psn-tr-100-try",
"name": "PlayStation Network Turkey 100 TRY",
"category": "gift_card",
"region": "TR",
"wholesale_price_usd": 2.94,
"fx_rate_lock_minutes": 15,
"stock": "available",
"fulfilment_sla_seconds": 60
}
],
"pagination": { "next_cursor": "Y3Vyc29yXzg5", "has_more": true }
}
4. Лимиты и ошибки
Песочница ограничена 60 запросами/минуту, production — 600/минуту на client_id. Превышение возвращает HTTP 429 с заголовком Retry-After в секундах. Реализуйте экспоненциальный backoff (250 мс, 500 мс, 1 с, 2 с, 5 с) и никогда не ретрайте на HTTP 4xx, кроме 408, 425, 429. Серверные ошибки (5xx) безопасно ретраить с идемпотентным ключом.
Готовы внедрить это в свой стек? FoxReload предоставляет бесплатные sandbox-ключи, коллекцию Postman и прямую поддержку в Slack для интеграционных команд — оставьте заявку на foxreload.com, чтобы начать закупать цифровые товары по оптовой марже уже на этой неделе.