free_amount; це значення може бути 0.
ℹ️ Цей інтерфейс належить до API керування платформою AceDataCloud, єдиний префікс https://platform.acedata.cloud/api/v1/. Повний індекс інтерфейсів див. у отриманні списку документів платформи AceDataCloud.
Повний процес інтеграції
Нові користувачі від реєстрації до успішного виклику першого бізнес-інтерфейсу зазвичай проходять ці 5 кроків:- Отримати токен облікового запису → Керування токенами облікового запису платформи AceDataCloud
- Обрати сервіс → Отримання списку сервісів платформи AceDataCloud
- Створити заявку (цей документ) → отримати початкову квоту відповідно до конфігурації сервісу
- Створити API-облікові дані → Створення API-облікових даних платформи AceDataCloud
- Викликати бізнес-інтерфейс → використовувати отриманий 32-символьний Token для виклику
https://api.acedata.cloud/<path>
Огляд інтерфейсу
Опис автентифікації (як отримати токен облікового запису)
Заголовок запиту:- Створення одним кліком у консолі (рекомендовано): увійдіть до платформи AceDataCloud → консолі Account Token → натисніть «Створити», щоб отримати токен, що починається з
platform-v1-. - Створення через API: використовуйте наявний токен облікового запису або JWT стану входу в браузері для виклику
POST /api/v1/platform-tokens/, докладніше див. у керуванні токенами облікового запису платформи AceDataCloud.
⚠️ Токен облікового запису є настільки ж конфіденційним, як пароль; заборонено записувати його у фронтенд-код або публічні репозиторії. У разі витоку негайно видаліть його в консолі та створіть заново.
Тіло запиту
Приклад запиту
cURL
Python
Node.js
Приклад відповіді
Успішно (HTTP 201)
Уже подано заявку (HTTP 400)
Сервіс не існує (HTTP 404)
Сервіс потребує перевірки (HTTP 403)
need_verify=true для сервісу (це поле можна побачити у списку сервісів), необхідно пройти процес звернення до служби підтримки для подання заявки до білого списку.
Обробка помилок
Єдиний формат відповіді про помилку:
Практичні поради
- Саме створення не списує кошти: під час першого створення початковий ліміт встановлюється відповідно до поточного
free_amountпослуги; це значення може бути 0, а повторне створення Application того самого типу не гарантує повторного надання. - Чи потрібна оплата, визначається полем
paid: одразу після подання заявкиpaid=false, після виклику створення замовлення на поповнення платформи AceDataCloud та завершення оплати воно стаєtrue. disabled=trueозначає тимчасове вимкнення — наприклад, через спрацювання контролю ризиків, заборгованість тощо. У вимкненому стані бізнес-інтерфейси повертатимуть403.- Не створюйте необмежено паралельно: спочатку отримайте цільовий
service_idзі списку послуг із пагінацією, а потім подавайте заявки по черзі відповідно до бізнес-потреб; у разіduplicationповторно використовуйте наявний Application.
Пов’язані інтерфейси
- Отримати список послуг платформи AceDataCloud — спочатку виберіть послугу
- Отримати список заявок на послуги платформи AceDataCloud — переглянути всі вже подані заявки
- Отримати деталі заявки на послугу платформи AceDataCloud — переглянути окрему заявку
- Створити облікові дані API платформи AceDataCloud — наступний крок після успішного подання заявки
- Створити замовлення на поповнення платформи AceDataCloud — поповнення після вичерпання безкоштовного ліміту
allow_overdraft за замовчуванням вимкнено та окремо надається адміністратором; його не можна ввімкнути самостійно через параметри запиту під час створення Application.
