Skip to main content
«Заявка (Application)» означає відносини підписки поточного облікового запису на певний сервіс — спочатку необхідно подати заявку, і лише потім можна створити для цієї заявки API-облікові дані та викликати бізнес-інтерфейси. Під час першої заявки на певний сервіс Application отримає поточне значення free_amount, налаштоване для цього сервісу; це значення може дорівнювати 0.
ℹ️ Цей інтерфейс належить до API керування платформою AceDataCloud з єдиним префіксом https://platform.acedata.cloud/api/v1/. Повний індекс інтерфейсів див. у Отримання списку документації платформи AceDataCloud.

Повний процес інтеграції

Нові користувачі зазвичай проходять ці 5 кроків від реєстрації до успішного виклику першого бізнес-інтерфейсу:
  1. Отримати токен облікового запису → Керування токенами облікового запису платформи AceDataCloud
  2. Вибрати сервіс → Отримання списку сервісів платформи AceDataCloud
  3. Створити заявку (цей документ) → отримати початкову квоту відповідно до конфігурації сервісу
  4. Створити API-облікові дані → Створення API-облікових даних платформи AceDataCloud
  5. Викликати бізнес-інтерфейс → використати отриманий 32-символьний Token для виклику https://api.acedata.cloud/<path>

Огляд інтерфейсу

Пояснення авторизації (як отримати токен облікового запису)

Заголовок запиту:
Токен облікового запису (Account Token) — це «ключ рівня облікового запису», який розробник використовує для керування ресурсами свого облікового запису через API. Способи отримання:
  1. Створення одним кліком у консолі (рекомендовано): увійдіть до платформи AceDataCloud → консолі Account Token → натисніть «Створити», щоб отримати токен, який починається з platform-v1-.
  2. Створення через API: використайте наявний токен облікового запису або JWT стану входу браузера для виклику POST /api/v1/platform-tokens/; докладніше див. у Керування токенами облікового запису платформи AceDataCloud.
⚠️ Токен облікового запису є настільки ж конфіденційним, як і пароль; заборонено записувати його у фронтенд-код або публічні репозиторії. У разі витоку негайно видаліть його в консолі та створіть заново.

Тіло запиту

Приклади запитів

cURL

Python

Node.js

Приклади відповідей

Успіх (HTTP 201)

Структура полів відповіді узгоджується з Отриманням деталей заявки на сервіс платформи AceDataCloud.

Заявку вже подано (HTTP 400)

Це жорстке обмеження в дизайні: кожен користувач може мати лише один Application для кожного сервісу. Якщо він уже існує, знайдіть наявний через Отримання списку заявок на сервіси платформи AceDataCloud.

Сервіс не існує (HTTP 404)

Сервіс потребує перевірки (HTTP 403)

Якщо для сервісу встановлено need_verify=true (це поле можна побачити у списку сервісів), необхідно пройти процес подання заявки через тікет для додавання до білого списку.

Обробка помилок

Єдиний формат відповіді про помилку:

Практичні поради

  • Саме створення не списує кошти: під час першого створення початковий ліміт встановлюється відповідно до поточного free_amount послуги; це значення може бути 0, а повторне створення Application того ж типу не гарантує повторного надання.
  • Чи потрібна оплата, дивіться за полем paid: щойно після подання заявки paid=false, після виклику Створити замовлення на поповнення платформи AceDataCloud для завершення оплати воно стає true.
  • disabled=true означає тимчасове вимкнення — наприклад, через спрацювання контролю ризиків, заборгованість тощо. Якщо вимкнено, бізнес-інтерфейси повертатимуть 403.
  • Не створюйте необмежену кількість заявок паралельно: спочатку отримайте цільовий service_id зі списку послуг із пагінацією, а потім подавайте заявки по черзі відповідно до бізнес-потреб; у разі duplication повторно використовуйте наявний Application.

Пов’язані інтерфейси