Skip to main content
El token de cuenta (Account Token, anteriormente llamado Platform Token) es una “clave de nivel de cuenta” que los desarrolladores utilizan para gestionar mediante programación los recursos de la plataforma AceDataCloud (solicitudes de servicios, credenciales de API, pedidos, registros de llamadas, saldo, archivos, etc.). Su función es similar al Token de usuario después de iniciar sesión en el frontend y, de forma predeterminada, no tiene fecha de expiración; los usuarios normales solo pueden gestionar sus propios tokens, mientras que los superadministradores pueden gestionar los tokens de otras cuentas según los permisos. Los tokens de cuenta acceden a las interfaces de la plataforma con los permisos actuales de la cuenta a la que pertenecen: se aplican combinadamente los permisos básicos, los permisos concedidos directamente y los permisos de los grupos de usuarios a los que pertenece; después de unirse a un grupo o ser eliminado de él, la siguiente solicitud se evaluará según los nuevos permisos. El acceso a recursos específicos, como solicitudes y pedidos, aún requiere una verificación de pertenencia. Los tokens de cuenta no expiran de forma predeterminada; utilícelos solo en entornos confiables y consérvelos adecuadamente.
ℹ️ Esta interfaz pertenece a la API de administración de la plataforma AceDataCloud, con el prefijo unificado https://platform.acedata.cloud/api/v1/. Para el índice completo de interfaces, consulte Obtener la lista de documentos de la plataforma AceDataCloud.

Token de cuenta vs credenciales de API

Los dos tipos de claves que los principiantes confunden con mayor facilidad; revíselos claramente primero: Si solo quiere probar GPT-4.1, lo que necesita son credenciales de API, no un token de cuenta. Si desea escribir scripts de automatización para gestionar recargas, ver facturas mensuales o distribuir credenciales en lote a miembros del equipo, entonces use un token de cuenta.

Crear con un clic en la consola (recomendado)

  1. Inicie sesión en https://platform.acedata.cloud.
  2. Vaya a la barra lateral → «Desarrollador» → «Account Token».
  3. Haga clic en el botón «Crear» en la esquina superior derecha para obtener inmediatamente un token platform-v1-..., haga clic en el botón de copiar y guárdelo en el gestor de contraseñas.
Consola de Account Token
⚠️ Las respuestas actuales de creación, lista y detalles devuelven el token en texto plano. Trate toda la respuesta como un secreto; no la escriba en registros, plataformas de análisis o almacenamiento persistente del frontend; el cliente tampoco debe depender de que la lista conserve la devolución en texto plano a largo plazo.

Crear un token de cuenta mediante API

Resumen de la interfaz

Explicación de autenticación (el problema del huevo y la gallina)

¿De dónde viene el primer token? La respuesta es desde la consola: después de iniciar sesión en el navegador, la consola llama a POST /platform-tokens/ autenticándose con JWT y le entrega el primer token. Después, puede usar cualquier token existente platform-v1-... para crear más.
Formato de los encabezados de solicitud:

Ejemplo de solicitud

Respuesta (HTTP 201)

Descripción de campos


Obtener la lista de tokens de cuenta

Resumen de la interfaz

Parámetros de consulta obligatorios

⚠️ Debe incluir ?user_id=<your_user_id>. Motivo: la interfaz de lista realiza una verificación de permisos por objeto sobre los resultados paginados; si no se incluye user_id, el primer objeto que no le pertenezca será rechazado y devolverá 403 permission_denied.
Cómo obtener user_id:
  1. Abra https://auth.acedata.cloud/user/profile en el navegador; la parte superior de la página muestra el UUID completo.
  2. O complete directamente el campo user_id del valor devuelto por POST /platform-tokens/.

Parámetros de consulta

Ejemplo de solicitud

Respuesta (HTTP 200)

La respuesta paginada de esta interfaz utiliza count + items. Otras interfaces de plataforma pueden utilizar estructuras diferentes; consulte la documentación correspondiente y la respuesta real.

Obtener detalles del token de cuenta

La estructura devuelta es consistente con el elemento de la lista, HTTP 200.

Eliminar token de cuenta

  • Si tiene éxito, devuelve HTTP 204 No Content, sin cuerpo de respuesta.
  • Después de eliminarlo, el token queda inmediatamente invalidado, y todos los servicios que lo estén utilizando recibirán 401 de inmediato.
  • Consultar de nuevo este id devolverá 404.
⚠️ La eliminación es irreversible. Si sospecha que el token se ha filtrado, puede crear primero uno nuevo, cambiar el lado de negocio y luego eliminar el antiguo.

Operaciones no compatibles


Referencia rápida de códigos de error

Formato unificado de respuesta de error:
Durante la investigación, proporcione el trace_id al servicio de atención al cliente o inclúyalo en el ticket para localizar rápidamente los registros.

Ejemplo de código completo

Python

Node.js


Uso en otras API de plataforma

Coloque directamente platform-v1-... en el encabezado Authorization: Bearer ... para llamar a cualquier interfaz de plataforma que requiera autorización:
Es completamente diferente de las credenciales API hexadecimales de 32 caracteres utilizadas por las interfaces de negocio https://api.acedata.cloud/** (OpenAI, Midjourney, Suno, Veo, etc.). No las mezcle: escribir un token de cuenta en una interfaz de negocio resultará en 401, y viceversa.

Interfaces relacionadas