Skip to main content
«Заявка (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.

Связанные интерфейсы