API реселлера
API реселлера: справочник методов
Все методы партнёрского API OneProvider в одной таблице: нужное право, признак идемпотентности и ссылка на спецификацию OpenAPI 3.1, удобно для импорта.
Все методы партнёрского API в одной таблице: нужное право, признак идемпотентности и ссылка на спецификацию OpenAPI 3.1.
Все модели, характеристики и цены Индекс документации для AI-агентов:https://oneprovider.dev/docs/llms.txt Базовый адрес: https://app.oneprovider.dev/partner/v1. Машиночитаемая спецификация OpenAPI 3.1: https://app.oneprovider.dev/partner/v1/openapi.yaml (публичная, без токена).
В колонке «Idempotency» отмечены методы, где заголовок Idempotency-Key обязателен. Право «any» значит любой действующий токен, «none» значит токен не нужен.
| Метод | Путь | Scope | Idempotency | Назначение |
|---|---|---|---|---|
GET | /me | any | - | Токен, права, реселлер. |
GET | /balance | read | - | Баланс реселлера, резерв, свободно, оптовая цена, кассы пополнения. |
GET | /balance/transactions | read | - | Проводки баланса (курсор). |
POST | /balance/topups | billing | обязателен | Создать платёж на пополнение, вернуть pay_url. |
GET | /balance/topups/{order_id} | billing | - | Статус своего платежа. |
GET | /pricing | read | - | Оптовая цена, скидка, лимиты. |
GET | /models | read | - | Каталог моделей и статус. |
GET | /customers | read | - | Список клиентов (?external_id=). |
GET | /customers/{id} | read | - | Клиент. |
POST | /customers | keys | - | Создать клиента. |
PATCH | /customers/{id} | keys | - | Изменить имя, заметку, заблокировать (blocked). |
GET | /keys | read | - | Список ключей (?status=, ?query=, ?customer_id=). |
GET | /keys/{id} | read | - | Ключ без секрета, с dashboard_url. |
GET | /keys/{id}/usage | read | - | Расход по дням (пока пусто, скоро). |
POST | /keys | keys | обязателен | Выпустить ключ; секрет в ответе один раз. |
POST | /keys/bulk | keys | обязателен | Выпустить несколько одинаковых ключей сразу. |
PATCH | /keys/{id} | keys | - | Лимит, срок (expires_days/hours) или продление (extend_days/hours), имя, метка клиента. |
DELETE | /keys/{id} | keys | - | Удалить ключ (200 или 202). |
POST | /keys/{id}/topup | keys | обязателен | Добавить сумму к лимиту ключа. |
POST | /keys/{id}/rotate | keys | обязателен | Перевыпустить ключ: новый секрет, старый перестаёт работать. |
POST | /keys/{id}/pause | keys | - | Поставить ключ на паузу. |
POST | /keys/{id}/resume | keys | - | Снять паузу. |
POST | /orders | keys | обязателен | Оплаченный заказ клиента: новый ключ или пополнение. |
GET | /orders | read | - | Список заказов (?external_order_id=). |
GET | /orders/{id} | read | - | Заказ. |
GET | /plans | read | - | Ваши тарифы. |
POST | /plans | plans | - | Создать тариф. |
PATCH | /plans/{id} | plans | - | Изменить тариф. |
DELETE | /plans/{id} | plans | - | Удалить тариф. |
GET | /code-batches | codes | - | Список пачек кодов. |
POST | /code-batches | codes | обязателен | Создать пачку кодов. |
GET | /code-batches/{id} | codes | - | Пачка. |
GET | /code-batches/{id}/codes | codes | - | Коды пачки (?status=). |
POST | /code-batches/{id}/revoke | codes | - | Отозвать непогашенные коды. |
GET | /codes/{code} | codes | - | Статус кода. |
POST | /codes/{code}/redeem | codes | обязателен | Погасить код в ключ. |
GET | /stats | read | - | Статистика по дням (?days=1..90). |
GET | /audit | read | - | Журнал действий (фильтры period, actor, action, q). |
GET | /bot | bot | - | Бот-магазин и бот поддержки (без токенов). |
GET | /payment-providers | bot | - | Кассы бота: CryptoBot, xRocket (без токенов). |
GET | /webhooks | webhooks | - | Список вебхуков. |
POST | /webhooks | webhooks | - | Создать вебхук; секрет один раз. |
DELETE | /webhooks/{id} | webhooks | - | Удалить вебхук. |
POST | /webhooks/{id}/test | webhooks | - | Отправить тестовое событие. |
GET | /webhooks/{id}/deliveries | webhooks | - | Журнал доставок. |
GET | /openapi.yaml | none | - | Спецификация OpenAPI 3.1 (публичная). |
Общие правила (пагинация, ошибки, лимиты) описаны на странице Авторизация и права .
Последнее обновление: 2026-10-21 Нашли ошибку? @Oneproviderhelpbot