Программный доступ к каталогу и покупкам с баланса. Авторизуйтесь по API-ключу с областями доступа, покупайте с баланса и проверяйте статус заказов — на том же движке, что и витрина.
API для реселлеров сейчас отключён на этом инстансе. Эндпоинты возвращают 404, пока оператор не включит его.
Создайте ключ с нужными областями доступа в личном кабинете и передавайте его как Bearer-токен (также принимается заголовок X-API-Key). Сам ключ показывается один раз при создании — храните его надёжно; у нас остаётся только хэш.
curl -H "Authorization: Bearer ask_xxxxxxxx_..." \
https://nexusmarket.one/api/v1/balanceКаждый ключ ограничен выданными ему областями. Эндпоинт вернёт 403, если у ключа нет нужной области доступа.
У каждого ключа свой лимит по схеме token-bucket (по умолчанию 100 запросов в минуту). При превышении возвращается 429 с заголовком Retry-After — сколько секунд подождать.
Передавайте необязательный заголовок Idempotency-Key при покупке, чтобы повтор не списал с баланса дважды: повтор с тем же ключом и телом вернёт исходный ответ; тот же ключ с другим телом — 409.
curl -X POST https://nexusmarket.one/api/v1/purchase \
-H "Authorization: Bearer ask_xxxxxxxx_..." \
-H "Idempotency-Key: order-2026-06-11-0001" \
-H "Content-Type: application/json" \
-d '{"productId":"clxyz...","quantity":2}'/productsКаталог с пагинацией, живым остатком и фиксированной ценой.
/products/{slug}Детали одного товара по slug с живым остатком.
/categoriesАктивное дерево категорий с локализацией.
/purchaseПокупка с баланса; выданные позиции возвращаются в ответе.
/order-statusСтатус и состав одного из ваших заказов.
/balanceВаш достоверный баланс кошелька в центах USD.
Каждая ошибка использует единый формат: стабильный машиночитаемый код, человекочитаемое сообщение и необязательные детали валидации по полям.
{
"ok": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Wallet balance is insufficient for this purchase"
}
}