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 — поповнення після вичерпання безкоштовного ліміту

