Gérer les jetons de compte de la plateforme AceDataCloud (Account Token)

ℹ️ Cette interface appartient à l’API de gestion de la plateforme AceDataCloud, avec le préfixe unifié https://platform.acedata.cloud/api/v1/. Pour l’index complet des interfaces, consultez Obtenir la liste des documents de la plateforme AceDataCloud.

​

Jeton de compte vs identifiant API

​

Créer en un clic dans la console (recommandé)

1. Connectez-vous à https://platform.acedata.cloud.
2. Accédez à la barre latérale → « Développeur » → « Account Token ».
3. Cliquez sur le bouton « Créer » en haut à droite pour obtenir immédiatement un jeton platform-v1-..., cliquez sur le bouton de copie pour l’enregistrer dans votre gestionnaire de mots de passe.

⚠️ Actuellement, les réponses de création, de liste et de détail renvoient toutes le jeton en clair. Veuillez traiter toute la réponse comme un secret, ne l’écrivez pas dans les journaux, les plateformes d’analyse ou le stockage persistant frontend ; les clients ne doivent pas non plus dépendre du maintien à long terme du retour en clair dans la liste.

​

Créer un jeton de compte avec l’API

​

Vue d’ensemble de l’interface

​

Explication de l’authentification (problème de l’œuf et de la poule)

Comment obtenir le premier jeton ? La réponse est de passer par la console — après la connexion dans le navigateur, la console appelle POST /platform-tokens/ avec l’authentification JWT et vous délivre le premier jeton. Ensuite, vous pouvez utiliser n’importe quel jeton platform-v1-... existant pour en créer davantage.

Authorization: Bearer ${PLATFORM_TOKEN}
Content-Type: application/json

​

Exemple de requête

curl -X POST 'https://platform.acedata.cloud/api/v1/platform-tokens/' \
  -H 'accept: application/json' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}" \
  -H 'content-type: application/json' \
  -d '{}'

​

Réponse (HTTP 201)

{
  "id": "3264f1aa-cbe1-4e2c-a434-95adba4f8304",
  "token": "platform-v1-<REDACTED>",
  "expiration": null,
  "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
  "created_at": "2026-04-26T15:50:11.123456Z",
  "updated_at": "2026-04-26T15:50:11.123456Z",
  "used_at": null
}

​

Description des champs

​

Obtenir la liste des jetons de compte

​

Vue d’ensemble de l’interface

​

Paramètre de requête obligatoire

⚠️ Vous devez inclure ?user_id=<your_user_id>. Raison : l’interface de liste effectue une vérification d’autorisation objet par objet sur les résultats paginés ; sans user_id, le premier objet ne vous appartenant pas sera refusé et renverra 403 permission_denied.

1. Ouvrez https://auth.acedata.cloud/user/profile dans le navigateur ; le UUID complet s’affiche en haut de la page.
2. Ou remplissez directement la valeur du champ user_id renvoyée par POST /platform-tokens/.

​

Paramètres de requête

​

Exemple de requête

curl 'https://platform.acedata.cloud/api/v1/platform-tokens/?user_id=89518d07-5560-4b05-92c1-667f3ddf6a4b&limit=5' \
  -H 'accept: application/json' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}"

​

Réponse (HTTP 200)

{
  "count": 2,
  "items": [
    {
      "id": "51c575a2-801c-4211-bc47-711452a8c8c9",
      "token": "platform-v1-<REDACTED>",
      "expiration": null,
      "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
      "created_at": "2026-04-26T15:41:32.761705Z",
      "updated_at": "2026-04-26T15:41:32.761726Z",
      "used_at": null
    }
  ]
}

La réponse paginée de cette interface utilise count + items. D’autres interfaces de plateforme peuvent utiliser des structures différentes ; veuillez vous référer à la documentation correspondante et aux réponses réelles.

​

Obtenir les détails d’un jeton de compte

curl 'https://platform.acedata.cloud/api/v1/platform-tokens/51c575a2-801c-4211-bc47-711452a8c8c9' \
  -H 'accept: application/json' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}"

​

Supprimer un jeton de compte

curl -X DELETE 'https://platform.acedata.cloud/api/v1/platform-tokens/3264f1aa-cbe1-4e2c-a434-95adba4f8304' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}"

• En cas de succès, retourne HTTP 204 No Content, sans corps de réponse.
• Après suppression, ce jeton devient immédiatement invalide, et tous les services qui l’utilisent recevront aussitôt un 401.
• Interroger à nouveau cet id retournera 404.

⚠️ La suppression est irréversible. Si vous soupçonnez une fuite du jeton, vous pouvez d’abord en créer un nouveau, basculer le côté métier, puis supprimer l’ancien.

​

Opérations non prises en charge

​

Référence rapide des codes d’erreur

{
  "detail": "You do not have permission to perform this action.",
  "code": "permission_denied",
  "trace_id": "0a88956213edf6e62b71695ee2df0eff"
}

​

Exemple de code complet

​

Python

import os
import requests

BASE = "https://platform.acedata.cloud/api/v1"
PLATFORM_TOKEN = os.environ["PLATFORM_TOKEN"]
USER_ID = "89518d07-5560-4b05-92c1-667f3ddf6a4b"

headers = {
    "accept": "application/json",
    "authorization": f"Bearer {PLATFORM_TOKEN}",
    "content-type": "application/json",
}

# 1. 创建新令牌
created = requests.post(f"{BASE}/platform-tokens/", headers=headers, json={}).json()
print("新令牌：", created["token"])
print("UserID：", created["user_id"])

# 2. 列表
listing = requests.get(
    f"{BASE}/platform-tokens/",
    headers=headers,
    params={"user_id": USER_ID, "limit": 50},
).json()
print(f"共 {listing['count']} 枚令牌")

# 3. 删除（注意末尾无斜杠）
resp = requests.delete(f"{BASE}/platform-tokens/{created['id']}", headers=headers)
assert resp.status_code == 204, resp.text

​

Node.js

const BASE = 'https://platform.acedata.cloud/api/v1'
const PLATFORM_TOKEN = process.env.PLATFORM_TOKEN
const USER_ID = '89518d07-5560-4b05-92c1-667f3ddf6a4b'

const headers = {
  accept: 'application/json',
  authorization: `Bearer ${PLATFORM_TOKEN}`,
  'content-type': 'application/json',
}

// 创建
const created = await fetch(`${BASE}/platform-tokens/`, {
  method: 'POST',
  headers,
  body: '{}',
}).then((r) => r.json())

// 列表
const url = new URL(`${BASE}/platform-tokens/`)
url.searchParams.set('user_id', USER_ID)
const listing = await fetch(url, { headers }).then((r) => r.json())
console.log(`共 ${listing.count} 枚令牌`)

// 删除（末尾无斜杠）
await fetch(`${BASE}/platform-tokens/${created.id}`, { method: 'DELETE', headers })

​

Utilisation dans d’autres API de plateforme

curl 'https://platform.acedata.cloud/api/v1/applications/?user_id=89518d07-5560-4b05-92c1-667f3ddf6a4b' \
  -H "authorization: Bearer ${PLATFORM_TOKEN}"

Ils sont entièrement différents des identifiants API hexadécimaux à 32 caractères utilisés par les interfaces métier https://api.acedata.cloud/** (OpenAI, Midjourney, Suno, Veo, etc.). Ne les mélangez pas — utiliser un jeton de compte dans une interface métier produira un 401, et inversement.

​

Interfaces associées

• Obtenir la liste des demandes de services de la plateforme AceDataCloud — utiliser le jeton de compte pour voir les services auxquels on a fait une demande
• Créer des identifiants API pour la plateforme AceDataCloud — utiliser le jeton de compte pour émettre des identifiants à 32 caractères destinés aux API métier
• Obtenir les enregistrements d’appels API de la plateforme AceDataCloud — vérifier la facturation et résoudre les erreurs
• Obtenir la liste des commandes de la plateforme AceDataCloud — consulter l’historique des recharges