Skip to main content
Konto-Token (Account Token, früher Platform Token genannt) sind „Schlüssel auf Kontoebene“, mit denen Entwickler AceDataCloud-Plattformressourcen (Serviceanträge, API-Anmeldedaten, Bestellungen, Aufrufprotokolle, Guthaben, Dateien usw.) programmatisch verwalten können. Ihre Funktion ähnelt dem Benutzer-Token nach einer Frontend-Anmeldung und sie haben standardmäßig keine Ablaufzeit; normale Benutzer können nur ihre eigenen Token verwalten, Superadministratoren können Token anderer Konten entsprechend ihren Berechtigungen verwalten. Konto-Token greifen mit den aktuellen Berechtigungen des zugehörigen Kontos auf Plattform-Schnittstellen zu: Grundberechtigungen, direkt gewährte Berechtigungen und Berechtigungen der zugehörigen Benutzergruppe werden zusammengeführt und wirksam; nach dem Beitritt zu oder dem Entfernen aus einer Gruppe wird die nächste Anfrage anhand der neuen Berechtigungen beurteilt. Der Zugriff auf konkrete Ressourcen wie Anträge und Bestellungen erfordert weiterhin eine Zuordnungsprüfung. Konto-Token laufen standardmäßig nicht ab. Verwenden Sie sie daher nur in vertrauenswürdigen Umgebungen und bewahren Sie sie sicher auf.
ℹ️ Diese Schnittstelle gehört zur AceDataCloud Plattformverwaltungs-API und verwendet einheitlich das Präfix https://platform.acedata.cloud/api/v1/. Den vollständigen Schnittstellenindex finden Sie unter AceDataCloud-Plattformdokumentliste abrufen.

Konto-Token vs. API-Anmeldedaten

Die zwei Arten von Schlüsseln, die Anfänger am leichtesten verwechseln. Bitte unterscheiden Sie sie zuerst klar: Wenn Sie nur GPT-4.1 aufrufen möchten, benötigen Sie API-Anmeldedaten, keine Konto-Token. Wenn Sie Automatisierungsskripte zur Verwaltung von Aufladungen schreiben, monatliche Rechnungen einsehen oder Anmeldedaten stapelweise an Teammitglieder verteilen möchten, verwenden Sie Konto-Token.

Mit einem Klick in der Konsole erstellen (empfohlen)

  1. Melden Sie sich bei https://platform.acedata.cloud an.
  2. Gehen Sie in der Seitenleiste zu → „Entwickler“ → „Account Token“.
  3. Klicken Sie oben rechts auf die Schaltfläche „Erstellen“, um sofort einen platform-v1-...-Token zu erhalten, und klicken Sie auf die Kopierschaltfläche, um ihn im Passwortmanager zu speichern.
Account-Token-Konsole
⚠️ Die aktuellen Antworten für Erstellung, Liste und Details geben alle den Token im Klartext zurück. Behandeln Sie die gesamte Antwort als Geheimnis und schreiben Sie sie nicht in Protokolle, Analyseplattformen oder Frontend-Persistenzen; Clients sollten sich auch nicht darauf verlassen, dass die Liste langfristig Klartext zurückgibt.

Konto-Token über die API erstellen

Schnittstellenübersicht

Hinweise zur Authentifizierung (Henne-Ei-Problem)

Woher kommt der erste Token? Die Antwort ist: über die Konsole – nach der Browser-Anmeldung ruft die Konsole mit JWT-Authentifizierung POST /platform-tokens/ auf und stellt Ihnen den ersten Token aus. Danach können Sie mit jedem vorhandenen platform-v1-...-Token weitere Token erstellen.
Format der Anfrage-Header:

Anfragebeispiel

Antwort (HTTP 201)

Feldbeschreibung


Konto-Token-Liste abrufen

Schnittstellenübersicht

Obligatorischer Abfrageparameter

⚠️ ?user_id=<your_user_id> muss angegeben werden. Grund: Die Listenschnittstelle führt für die Paginierungsergebnisse objektweise Berechtigungsprüfungen durch. Wenn user_id nicht angegeben wird, wird das erste Objekt, das nicht Ihnen gehört, abgelehnt und 403 permission_denied zurückgegeben.
So erhalten Sie die user_id:
  1. Öffnen Sie im Browser https://auth.acedata.cloud/user/profile; oben auf der Seite wird die vollständige UUID angezeigt.
  2. Oder füllen Sie direkt das Feld user_id aus dem Rückgabewert von POST /platform-tokens/ ein.

Abfrageparameter

Anfragebeispiel

Antwort (HTTP 200)

Die paginierte Antwort dieser Schnittstelle verwendet count + items. Andere Plattform-Schnittstellen können andere Strukturen verwenden; maßgeblich sind die jeweilige Dokumentation und die tatsächliche Antwort.

Kontotoken-Details abrufen

Die Rückgabestruktur entspricht einem Listenelement, HTTP 200.

Kontotoken löschen

  • Bei Erfolg wird HTTP 204 No Content ohne Antwortkörper zurückgegeben.
  • Nach dem Löschen wird der Token sofort ungültig, und alle Dienste, die ihn verwenden, erhalten unmittelbar 401.
  • Eine erneute Abfrage dieser id gibt 404 zurück.
⚠️ Das Löschen ist irreversibel. Wenn du vermutest, dass der Token kompromittiert wurde, kannst du zuerst einen neuen erstellen, die Geschäftsseite umstellen und dann den alten löschen.

Nicht unterstützte Operationen


Fehlercode-Schnellübersicht

Einheitliches Format der Fehlerantwort:
Gib bei der Fehlerbehebung trace_id dem Kundendienst an oder füge sie in das Ticket ein, um die Protokolle schnell zu lokalisieren.

Vollständige Codebeispiele

Python

Node.js


Verwendung in anderen Plattform-APIs

Füge platform-v1-... direkt in den Header Authorization: Bearer ... ein, um jede Plattform-Schnittstelle aufzurufen, die eine Authentifizierung erfordert:
Dies unterscheidet sich vollständig von den 32-stelligen hexadezimalen API-Anmeldedaten, die von den Geschäftsschnittstellen unter https://api.acedata.cloud/** (OpenAI, Midjourney, Suno, Veo usw.) verwendet werden. Bitte nicht verwechseln — wenn du den Kontotoken in eine Geschäftsschnittstelle schreibst, erhältst du 401, und umgekehrt ebenso.

Verwandte Schnittstellen