Що нового в API Voodoo Center

Кожна помітна зміна в API Voodoo Center та його інтеграційній поверхні фіксується тут, від найновіших. API версіонується під /api/v1; ми додаємо поля та ендпоінти у зворотно сумісний спосіб і окремо зазначаємо все, на що вам може знадобитися відреагувати.

Хочете отримувати сповіщення про зміни програмно? Нові результати замовлень завжди надходять на ваш webhook, а кожне поле, задокументоване в API Reference, можна безпечно читати захисно — ігноруйте невідомі поля, щоб майбутні доповнення ніколи не ламали вашу інтеграцію.

Запуск API v1 — замовлення, баланс і webhooks

API Voodoo Center працює. Тепер ви можете купувати цифрові товари — ключі подарункових карток, поповнення та ігрові послуги — безпосередньо з ваших систем.

Ендпоінти

  • POST /api/v1/auth/token/client — обмін API-ключа ak_ на короткоживучий (2 години) Bearer-токен доступу.
  • GET /api/v1/account/balance — прочитати доступний для витрат баланс.
  • POST /api/v1/orders — розмістити замовлення. Списує ваш баланс і повертає 201 зі status: "pending"; виконання відбувається асинхронно.
  • GET /api/v1/orders/{id} — отримати поточний стан одного зі своїх замовлень.

Webhook статусу замовлення

Коли замовлення, розміщене через API, досягає термінального статусу (completed, failed або partial), ми надсилаємо (POST) підписану подію на налаштовану вами webhook-URL. Запити несуть заголовок X-Webhook-Signature: sha256=<hex> (HMAC-SHA256 над сирим тілом) і повторюються до 3 разів з інтервалом 60 секунд у разі будь-якої відповіді, що не є 200.