> 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 або зі свого власного бекенду.