Перейти до основного вмісту
«Заявка (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.

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

allow_overdraft за замовчуванням вимкнено та окремо надається адміністратором; його не можна ввімкнути самостійно через параметри запиту під час створення Application.