Що нового в 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.