Перейти к основному содержанию
«Заявка (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.
⚠️ Токен аккаунта столь же конфиденциален, как пароль; запрещено записывать его в frontend-код или публичные репозитории. При утечке немедленно удалите и создайте его заново в консоли.

Тело запроса

Примеры запросов

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 его нельзя включить самостоятельно через параметры запроса.