Skip to main content
Token konta (Account Token, wcześniej nazywany Platform Token) jest „kluczem na poziomie konta”, za pomocą którego deweloperzy programowo zarządzają zasobami platformy AceDataCloud (wnioskami o usługi, poświadczeniami API, zamówieniami, rejestrami wywołań, saldem, plikami itd.). Jego działanie jest podobne do Tokena użytkownika po zalogowaniu się w interfejsie frontendowym i domyślnie nie ma terminu ważności; zwykli użytkownicy mogą zarządzać wyłącznie własnymi tokenami, a superadministratorzy mogą zarządzać tokenami innych kont zgodnie z uprawnieniami. Token konta uzyskuje dostęp do interfejsów platformy z bieżącymi uprawnieniami należącego do niego konta: uprawnienia podstawowe, uprawnienia nadane bezpośrednio oraz uprawnienia grup użytkowników są łączone i obowiązują razem; po dołączeniu do grupy lub usunięciu z niej kolejne żądanie zostanie ocenione według nowych uprawnień. Dostęp do konkretnych zasobów, takich jak wnioski i zamówienia, nadal wymaga weryfikacji przynależności. Token konta domyślnie nie wygasa, dlatego używaj go wyłącznie w zaufanym środowisku i przechowuj go bezpiecznie.
ℹ️ Ten interfejs należy do API zarządzania platformą AceDataCloud, ze wspólnym prefiksem https://platform.acedata.cloud/api/v1/. Pełny indeks interfejsów znajduje się w Pobierz listę dokumentacji platformy AceDataCloud.

Token konta vs poświadczenia API

Dwa rodzaje kluczy, które początkujący najczęściej mylą — najpierw wyraźnie je rozróżnij: Jeśli chcesz tylko wywołać GPT-4.1, potrzebujesz poświadczeń API, a nie tokena konta. Jeśli chcesz napisać skrypt automatyzujący zarządzanie doładowaniami, przeglądanie miesięcznych rachunków lub masowe wydawanie poświadczeń członkom zespołu, wtedy użyj tokena konta.

Utwórz jednym kliknięciem w konsoli (zalecane)

  1. Zaloguj się do https://platform.acedata.cloud.
  2. Przejdź do paska bocznego → „Deweloper” → „Account Token”.
  3. Kliknij przycisk „Utwórz” w prawym górnym rogu, aby natychmiast otrzymać token platform-v1-...; kliknij przycisk kopiowania i zapisz go w menedżerze haseł.
Konsola Account Token
⚠️ Obecnie odpowiedzi dotyczące tworzenia, listy i szczegółów zwracają token w postaci jawnego tekstu. Traktuj całą odpowiedź jako sekret — nie zapisuj jej w logach, platformach analitycznych ani trwałej pamięci frontendu; klient nie powinien również polegać na tym, że lista długoterminowo będzie zwracać tekst jawny.

Tworzenie tokena konta za pomocą API

Przegląd interfejsu

Wyjaśnienie uwierzytelniania (problem jajka i kury)

Skąd wziąć pierwszy token? Odpowiedź brzmi: przez konsolę — po zalogowaniu w przeglądarce konsola wywołuje POST /platform-tokens/ z uwierzytelnianiem JWT i wydaje Ci pierwszy token. Następnie możesz użyć dowolnego istniejącego tokena platform-v1-..., aby utworzyć kolejne.
Format nagłówków żądania:

Przykład żądania

Odpowiedź (HTTP 201)

Opis pól


Pobieranie listy tokenów konta

Przegląd interfejsu

Wymagane parametry zapytania

⚠️ Musisz przekazać ?user_id=<your_user_id>. Powód: interfejs listy wykonuje kontrolę uprawnień dla każdego obiektu w wynikach paginacji; gdy nie przekażesz user_id, pierwszy obiekt, który do Ciebie nie należy, zostanie odrzucony i zwróci 403 permission_denied.
Jak uzyskać user_id:
  1. Otwórz w przeglądarce https://auth.acedata.cloud/user/profile; pełny UUID jest wyświetlany u góry strony.
  2. Możesz też bezpośrednio wpisać ponownie wartość pola user_id z odpowiedzi POST /platform-tokens/.

Parametry zapytania

Przykład żądania

Odpowiedź (HTTP 200)

Odpowiedź stronicowana tego interfejsu używa count + items. Inne interfejsy platformy mogą używać innej struktury; należy kierować się odpowiednią dokumentacją i rzeczywistą odpowiedzią.

Pobieranie szczegółów tokena konta

Struktura zwracana jest zgodna z elementem listy, HTTP 200.

Usuwanie tokena konta

  • Przy powodzeniu zwracane jest HTTP 204 No Content, bez treści odpowiedzi.
  • Po usunięciu token natychmiast traci ważność, a wszystkie usługi, które go używają, od razu otrzymają 401.
  • Ponowne zapytanie o ten id zwróci 404.
⚠️ Usunięcie jest nieodwracalne. Jeśli podejrzewasz wyciek tokena, możesz najpierw utworzyć nowy, przełączyć stronę biznesową, a następnie usunąć stary.

Nieobsługiwane operacje


Szybki przegląd kodów błędów

Ujednolicony format odpowiedzi błędu:
Podczas diagnozowania przekaż trace_id obsłudze klienta lub umieść go w zgłoszeniu, aby szybko zlokalizować logi.

Pełne przykłady kodu

Python

Node.js


Używanie w innych interfejsach API platformy

Umieść platform-v1-... bezpośrednio w nagłówku Authorization: Bearer ..., aby wywołać dowolny interfejs platformy wymagający autoryzacji:
Jest on całkowicie inny niż 32-znakowe szesnastkowe poświadczenie API używane przez interfejsy biznesowe https://api.acedata.cloud/** (OpenAI, Midjourney, Suno, Veo itd.). Nie należy ich mieszać — wpisanie tokena konta do interfejsu biznesowego spowoduje 401 i odwrotnie.

Powiązane interfejsy