REST API · Votway
Публичный API
Создавайте заказы из своих скриптов и сервисов. Ключ — в кабинете: Настройки → API.
Авторизация
Передайте API-ключ в заголовке для каталога, баланса, транзакций и заказов.
POST /api/v1/orders
{
"service_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"link": "https://t.me/channel",
"quantity": 1000
}Платформы и услуги
Сначала платформы и категории, затем услуги. В заказ идёт id услуги (service_id). Смотрите order_type: default — ссылка и quantity; subscription — username и extra.min/max/posts либо пакет link+quantity; autoclick — канал или chat_id; traffic — ссылка, объём и extra с интервалом.
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /catalog/platforms | X-API-Key | Платформы витрины (Telegram, VK, …). id платформы в заказ не передаётся |
| GET | /catalog/categories | X-API-Key | Категории. Поле platform и id — фильтр GET /catalog/services?category_id= |
| GET | /catalog/services?category_id= | X-API-Key | Услуги: id, order_type, min/max, цена. Цены со скидкой владельца ключа |
| GET | /catalog/services/{service_id} | X-API-Key | Одна услуга — отсюда service_id для заказа |
| POST | /catalog/calculate | X-API-Key | Предрасчёт: { service_id, quantity } → amount, currency |
Аккаунт
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /profile/balance | X-API-Key | Текущий баланс (RUB) |
| GET | /transactions | X-API-Key | История транзакций |
| GET | /transactions/{transaction_id} | X-API-Key | Одна транзакция |
Заказы
Отмена — POST /cancel, если allow_user_cancel. Пауза и возобновление — /stop и /start при can_stop / can_start. Правки автоклика и трафика — PATCH при can_edit. Статус поллите GET, webhook нет. refill пока 501.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /orders | X-API-Key | Создать заказ: service_id, link/quantity или extra по order_type услуги |
| GET | /orders | X-API-Key | Список (limit≤300, offset, search, platform, status_group, order_type) |
| GET | /orders/{order_id} | X-API-Key | Статус, прогресс, флаги can_stop/can_start/can_edit, дочерние задачи |
| POST | /orders/{order_id}/cancel | X-API-Key | Отмена, если allow_user_cancel. Ответ: заказ, refund_amount, balance |
| POST | /orders/{order_id}/stop | X-API-Key | Пауза автоклика, трафика или автопостинга, если can_stop |
| POST | /orders/{order_id}/start | X-API-Key | Возобновление, если can_start |
| PATCH | /orders/{order_id} | X-API-Key | Правки автоклика/трафика, если can_edit: клики, интервал, geo, source |
Автоклик: каналы
Для закрытого Telegram: check-channel → connect-code (код боту) → channels (chat_id) → POST /orders с chat_id. Для MAX: connect-link → channels → заказ с platform=max и chat_id.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /orders/autoclick/check-channel | X-API-Key | Проверка канала: service_id + channel или chat_id |
| POST | /orders/autoclick/telegram/connect-code | X-API-Key | Код для бота в закрытом Telegram-канале |
| POST | /orders/autoclick/telegram/channels | X-API-Key | Подключённые Telegram-каналы (опц. refresh, chat_id) |
| POST | /orders/autoclick/max/connect-link | X-API-Key | Персональная ссылка подключения MAX |
| POST | /orders/autoclick/max/channels | X-API-Key | Подключённые MAX-каналы (опц. refresh, chat_id) |
Swagger
Интерактивная документация: все методы, поля запросов и ответов, примеры тел. Можно сразу выполнить запрос со своим ключом.
Ошибки и лимиты
Ответы ошибок: {"detail": "..."}. 401 — нет или неверный ключ. 429 — подождите и повторите. POST /orders/{id}/refill возвращает 501. Пополнение баланса по ключу недоступно.