Gestire i token dell'account della piattaforma AceDataCloud (Account Token)

ℹ️ Questa interfaccia appartiene alla API di gestione della piattaforma AceDataCloud, con prefisso unificato https://platform.acedata.cloud/api/v1/. Per l’indice completo delle interfacce, consulta l’elenco della documentazione della piattaforma AceDataCloud.

​

Token dell’account vs credenziali API

​

Creazione con un clic nella console (consigliato)

1. Accedi a https://platform.acedata.cloud.
2. Vai alla barra laterale → «Sviluppatore» → «Account Token».
3. Fai clic sul pulsante «Crea» in alto a destra per ottenere immediatamente un token platform-v1-..., fai clic sul pulsante copia e salvalo nel gestore delle password.

⚠️ Attualmente le risposte di creazione, elenco e dettagli restituiscono tutte il token in chiaro. Tratta l’intera risposta come un segreto, non scriverla nei log, nelle piattaforme di analisi o nella persistenza frontend; inoltre il client non dovrebbe dipendere dalla restituzione a lungo termine del testo in chiaro nell’elenco.

​

Creare un token dell’account tramite API

​

Panoramica dell’interfaccia

​

Istruzioni per l’autenticazione (problema dell’uovo e della gallina)

Come si ottiene il primo token? La risposta è tramite la console — dopo l’accesso nel browser, la console chiama POST /platform-tokens/ con autenticazione JWT e ti assegna il primo token. Successivamente puoi utilizzare qualsiasi token platform-v1-... esistente per crearne altri.

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

​

Esempio di richiesta

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 '{}'

​

Risposta (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
}

​

Descrizione dei campi

​

Ottenere l’elenco dei token dell’account

​

Panoramica dell’interfaccia

​

Parametro di query obbligatorio

⚠️ Devi includere ?user_id=<your_user_id>. Motivo: l’interfaccia di elenco esegue il controllo delle autorizzazioni oggetto per oggetto sui risultati paginati; se user_id non viene incluso, il primo oggetto che non ti appartiene verrà rifiutato, restituendo 403 permission_denied.

1. Apri nel browser https://auth.acedata.cloud/user/profile, nella parte superiore della pagina viene visualizzato l’UUID completo.
2. Oppure inserisci direttamente il campo user_id nel valore restituito da POST /platform-tokens/.

​

Parametri di query

​

Esempio di richiesta

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}"

​

Risposta (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 risposta paginata di questa interfaccia utilizza count + items. Altre interfacce della piattaforma potrebbero utilizzare strutture diverse; fare riferimento alla documentazione corrispondente e alla risposta effettiva.

​

Ottieni i dettagli del token dell’account

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

​

Elimina il token dell’account

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

• In caso di successo restituisce HTTP 204 No Content, senza corpo della risposta.
• Dopo l’eliminazione, il token diventa immediatamente non valido e tutti i servizi che lo stanno utilizzando riceveranno subito 401.
• Una nuova query di questo id restituirà 404.

⚠️ L’eliminazione è irreversibile. Se sospetti che il token sia stato divulgato, puoi prima crearne uno nuovo, cambiare lato business, poi eliminare quello vecchio.

​

Operazioni non supportate

​

Riferimento rapido dei codici di errore

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

​

Esempio di codice completo

​

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 })

​

Utilizzo in altre API della piattaforma

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

È completamente diverso dalle credenziali API esadecimali a 32 caratteri utilizzate dalle interfacce business https://api.acedata.cloud/** (OpenAI, Midjourney, Suno, Veo ecc.). Non confonderli: inserire il token dell’account nell’interfaccia business restituirà 401, e viceversa.

​

Interfacce correlate

• Ottieni l’elenco delle richieste di servizi della piattaforma AceDataCloud — usa il token dell’account per vedere quali servizi hai richiesto
• Crea le credenziali API della piattaforma AceDataCloud — usa il token dell’account per emettere credenziali a 32 caratteri per le API aziendali
• Ottieni i registri delle chiamate API della piattaforma AceDataCloud — per verificare i conti e risolvere gli errori
• Ottieni l’elenco degli ordini della piattaforma AceDataCloud — per controllare la cronologia delle ricariche