API для реселлеров
Подключите сайт или бота
Смотрите товары, баланс, покупайте и проверяйте заказы ключом из личного кабинета.
Авторизация
Передавайте ключ в заголовке X-Api-Key. Создайте его на вкладке API в аккаунте. Полный ключ показывается один раз.
Список товаров
GET /api/v1/products
Возвращает страны, которые можно продавать, с текущей ценой и остатком. Фильтры: tier=old или tier=new, country — код ISO или id страны.
curl
curl "https://acceptororg.com/api/v1/products?tier=old&country=IT" \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/products?tier=new", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();Баланс
GET /api/v1/balance
Возвращает баланс владельца ключа в долларах.
curl
curl https://acceptororg.com/api/v1/balance \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/balance", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();Покупка
POST /api/v1/buy
Списывает баланс и создаёт заказ. Заголовок Idempotency-Key позволяет безопасно повторить тот же запрос.
curl
curl https://acceptororg.com/api/v1/buy \
-H "X-Api-Key: acc_your_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001" \
-d '{"country":"IT","tier":"old","quantity":1}'JavaScript
const res = await fetch("https://acceptororg.com/api/v1/buy", {
method: "POST",
headers: {
"X-Api-Key": "acc_your_key",
"Content-Type": "application/json",
"Idempotency-Key": "order-1001",
},
body: JSON.stringify({ country: "IT", tier: "old", quantity: 1 }),
});
const data = await res.json();Статус заказа
GET /api/v1/orders/:id
Возвращает статус вашего заказа. Если есть download_url, запросите его с тем же ключом. Это наш прокси, не адрес поставщика.
curl
curl https://acceptororg.com/api/v1/orders/ORDER_ID \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/orders/ORDER_ID", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();Лимит
Каждый ключ — 60 запросов в минуту, если не задан другой лимит. Лишние запросы получают 429.
Коды ошибок
unauthorized
Ключ отсутствует, неизвестен или отозван.
rate_limited
Слишком много запросов за эту минуту.
invalid_request
В запросе не хватает поля или значение неверное.
not_found
Этот заказ не принадлежит ключу.
insufficient_balance
Баланса не хватает на заказ.
out_of_stock
Недостаточно остатка на это количество.
price_unavailable
Эта страна и тип не продаются.
price_increased
Живая цена выше объявленной. Деньги не списаны.
unverified
Не удалось проверить остаток. Деньги не списаны.
sourcing_failed
Поставщик отклонил заказ. Баланс возвращён.
idempotency_conflict
Этот Idempotency-Key уже использован для другого запроса.
idempotency_in_progress
Запрос с этим Idempotency-Key ещё выполняется.
unavailable
База API ещё не готова.