REST API · Votway
Публичный API
Создавайте заказы из своих скриптов и сервисов. Ключ — в кабинете: Настройки → API.
Авторизация
Для заказов передайте API-ключ в заголовке. Каталог доступен без ключа.
POST /api/v1/orders
{
"service_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"link": "https://t.me/channel",
"quantity": 1000
}Каталог
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /catalog/platforms | - | Список платформ витрины |
| GET | /catalog/categories | - | Категории услуг |
| GET | /catalog/services?category_id= | - | Услуги категории |
| POST | /catalog/calculate | - | Расчёт цены: service_id + quantity |
Заказы
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /orders | X-API-Key | Создать заказ |
| GET | /orders | X-API-Key | Список заказов (limit, offset, фильтры) |
| GET | /orders/{order_id} | X-API-Key | Статус и детали заказа |
Ошибки и лимиты
Ответы ошибок: {"detail": "..."}. При 429 подождите и повторите запрос. Полный справочник — в репозитории docs/api/.