> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.voodoo.center/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.voodoo.center/_mcp/server.

# Обзор

Этот раздел — полный интерактивный справочник API Voodoo Center,
сгенерированный из нашей спецификации OpenAPI. Каждый эндпоинт перечисляет свои
параметры, схемы запроса и ответа, примеры полезной нагрузки и **API Explorer**,
с помощью которого вы можете отправлять реальные запросы.

## Эндпоинты

Программный API имеет три эндпоинта, а также эндпоинт обмена токена,
используемый для аутентификации:

| Метод  | Путь                        | Назначение                                                 |
| ------ | --------------------------- | ---------------------------------------------------------- |
| `POST` | `/api/v1/auth/token/client` | Обмен API-ключа `ak_` на Bearer-токен.                     |
| `GET`  | `/api/v1/account/balance`   | Прочитать доступный для трат баланс.                       |
| `POST` | `/api/v1/orders`            | Разместить заказ (списывает баланс, возвращает `pending`). |
| `GET`  | `/api/v1/orders/{id}`       | Получить один из своих заказов.                            |

Справочник также документирует исходящий **webhook статуса заказа**, который
Voodoo Center отправляет на ваш URL, когда заказ завершается. Детали проверки
см. в [руководстве по Webhooks](/webhooks).

## Аутентификация API Explorer — введите только свой API-ключ

Explorer обрабатывает аутентификацию за вас. Вы предоставляете **только свой
API-ключ `ak_`**; он получает токен доступа автоматически.

Откройте панель авторизации и вставьте свой API-ключ `ak_`. Это единственные
учётные данные, которые вы предоставляете — никакой JWT вставлять не нужно.

Когда вы отправляете запрос, Explorer сначала вызывает
`POST /api/v1/auth/token/client` с вашим ключом, а затем использует
полученный `access_token` как `Authorization: Bearer <token>` в вызове. Сам
эндпоинт обмена токена публичный, поэтому не требует авторизации.

Токены доступа действуют 2 часа; Explorer прозрачно повторно обменивает ваш
ключ по мере необходимости, поэтому вы можете и дальше пробовать эндпоинты,
ничего не вводя повторно.

Explorer отправляет живые запросы на `https://api.voodoo.center` — те же вызовы,
которые вы можете делать через cURL или со своего собственного бэкенда.