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

Огляд інтерфейсу

Пояснення авторизації (проблема курки та яйця)

Як отримати перший токен? Відповідь — через консоль: після входу в браузері консоль використовує JWT-авторизацію для виклику POST /platform-tokens/ і видає вам перший токен. Після цього ви можете використовувати будь-який наявний токен 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, і навпаки.

Пов’язані інтерфейси