Skip to main content
Токен аккаунта (Account Token, ранее Platform Token) — это «ключ уровня аккаунта», с помощью которого разработчики программно управляют ресурсами платформы AceDataCloud (заявками на услуги, API-учётными данными, заказами, записями вызовов, балансом, файлами и т. д.). Его роль аналогична пользовательскому Token после входа во фронтенд; по умолчанию он не имеет срока действия. Обычные пользователи могут управлять только своими токенами, а суперадминистраторы могут в соответствии с правами управлять токенами других аккаунтов. Токен аккаунта обращается к интерфейсам платформы с текущими правами принадлежащего ему аккаунта: базовые права, непосредственно предоставленные права и права групп пользователей объединяются и вступают в силу; после добавления в группу или удаления из неё следующая операция будет проверяться по новым правам. Доступ к конкретным ресурсам, таким как заявки и заказы, по-прежнему требует проверки принадлежности. Токен аккаунта по умолчанию не истекает, используйте его только в доверенной среде и надёжно храните.
ℹ️ Этот интерфейс относится к API управления платформой AceDataCloud, единый префикс: https://platform.acedata.cloud/api/v1/. Полный индекс интерфейсов см. в Получить список документации платформы AceDataCloud.

Токен аккаунта vs API-учётные данные

Два типа ключей, которые новички чаще всего путают, сначала внимательно ознакомьтесь: Если вы просто хотите вызвать GPT-4.1, вам нужны API-учётные данные, а не токен аккаунта. Если вы хотите написать автоматизированный скрипт для управления пополнениями, просмотра ежемесячных счетов, массовой выдачи учётных данных членам команды — тогда используйте токен аккаунта.

Создание в консоли одним нажатием (рекомендуется)

  1. Войдите на https://platform.acedata.cloud.
  2. Перейдите в боковом меню → «Разработчик» → «Account Token».
  3. Нажмите кнопку «Создать» в правом верхнем углу, и сразу получите токен platform-v1-..., нажмите кнопку копирования и сохраните его в менеджере паролей.
Консоль Account Token
⚠️ Текущие ответы создания, списка и деталей возвращают токен в открытом виде. Обращайтесь со всем ответом как с секретом, не записывайте его в журналы, аналитические платформы или постоянное хранилище фронтенда; клиент также не должен полагаться на то, что список будет постоянно возвращать открытый текст.

Создание токена аккаунта через API

Обзор интерфейса

Описание аутентификации (проблема курицы и яйца)

Как получить первый токен? Ответ — через консоль: после входа в браузере консоль вызывает POST /platform-tokens/ с JWT-аутентификацией и выдаёт вам первый токен. После этого вы можете использовать любой существующий токен platform-v1-... для создания новых.
Формат заголовков запроса:

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

Ответ (HTTP 201)

Описание полей


Получение списка токенов аккаунта

Обзор интерфейса

Обязательные параметры запроса

⚠️ Необходимо передать ?user_id=<your_user_id>. Причина: интерфейс списка выполняет проверку прав для каждого объекта в результатах пагинации; если user_id не передан, при первом объекте, который вам не принадлежит, запрос будет отклонён с ответом 403 permission_denied.
Как получить user_id:
  1. Откройте в браузере https://auth.acedata.cloud/user/profile, в верхней части страницы отображается полный UUID.
  2. Или напрямую подставьте обратно поле user_id из ответа POST /platform-tokens/.

Параметры запроса

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

Ответ(HTTP 200)

Ответ с пагинацией этого интерфейса использует count + items. Другие интерфейсы платформы могут использовать иную структуру, ориентируйтесь на соответствующую документацию и фактический ответ.

Получение сведений о токене учётной записи

Структура ответа совпадает с элементом списка, HTTP 200.

Удаление токена учётной записи

  • При успехе возвращается HTTP 204 No Content, без тела ответа.
  • После удаления токен немедленно становится недействительным, все использующие его сервисы сразу получат 401.
  • Повторный запрос этого id вернёт 404.
⚠️ Удаление необратимо. Если вы подозреваете утечку токена, можно сначала создать новый, переключить бизнес-сторону, а затем удалить старый.

Неподдерживаемые операции


Краткая справка по кодам ошибок

Единый формат ответа об ошибке:
При диагностике предоставьте trace_id службе поддержки или укажите его в тикете — это позволит быстро найти логи.

Полный пример кода

Python

Node.js


Использование в других API платформы

Поместите platform-v1-... напрямую в заголовок Authorization: Bearer ..., чтобы вызывать любой интерфейс платформы, требующий авторизации:
Он полностью отличается от 32-значного шестнадцатеричного API-ключа, используемого бизнес-интерфейсами https://api.acedata.cloud/** (OpenAI, Midjourney, Suno, Veo и т. д.). Не смешивайте их — если указать токен учётной записи в бизнес-интерфейсе, вы получите 401, и наоборот.

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