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 — пополнение после исчерпания бесплатной квоты

