Saltar al contenido
Verificada

Leer la cuenta con sesión iniciada

Obtén el mismo registro de cuenta que lee la carga de una página del dashboard, con una sola llamada y sin campos.

get_account_info es la misma llamada que hace el dashboard en cada carga de página: sin más parámetros que tu credencial, devuelve un registro de cuenta que cubre plan, uso, almacenamiento y estado de facturación en un solo viaje. Úsala siempre que tu propio backend necesite saber con quién habla, o en qué plan y cuota está esa cuenta ahora mismo.

Método

POST/cpi/get_account_info
user

Get Account Info

Returns the account data for the requesting user, optionally enforcing usage limits.

Paso a paso

Llámala solo con tu clave

get_account_info no declara campos propios. La cuenta a la que responde es la que autentica tu credencial: una clave de API de cuenta o de proyecto en el cuerpo, o la cabecera xu-gtp-token de un visitante con sesión iniciada si llamas desde una sesión de navegador.

curl -s https://xuda.ai/cpi/get_account_info \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY"}'
const res = await fetch('https://xuda.ai/cpi/get_account_info', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY' }),
});
const { code, data } = await res.json();
if (code > 0) console.log(data.account_info.email, data.membership_plan);
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_account_info',
    json={'api_key': 'YOUR_API_KEY'},
)
body = res.json()
if body['code'] > 0:
    print(body['data']['account_info']['email'], body['data']['membership_plan'])

La respuesta

data es el documento de la cuenta, recortado a lo que debe leer un cliente. Los campos de abajo son las claves reales con las que get_account_data construye la respuesta, no una muestra de una estructura mayor desconocida:

json
{
  "code": 1,
  "data": {
    "_id": "acc_8f2a1c",
    "uid": "acc_8f2a1c",
    "account_info": {
      "email": "[email protected]",
      "first_name": "Jordan",
      "last_name": "Rivera",
      "phone_number": "+1 555 0142"
    },
    "stat": 3,
    "is_boarded": true,
    "membership_plan": "growth",
    "plan_info": { "...": "the current plan's own fields" },
    "support_plan": "standard",
    "ai_workspace_plan": "starter",
    "account_project_id": "app_5d9e21",
    "account_hosted_email": null,
    "drive_plan": "drive_free",
    "drive_usage": {
      "user_drive_size": 18291029,
      "studio_drive_size": 402981,
      "workspace_drive_size": 0,
      "total_drive_size": 18694010,
      "quota_bytes": 5368709120,
      "quota_unlimited": false
    },
    "billing_status": {
      "account_suspension_status": null,
      "account_billing_hold_status": null,
      "account_termination_status": null,
      "account_email_bounce_suspended": 0
    },
    "preferences": {},
    "login_screen": { "...": "the effective pre-auth login screen for this account" }
  }
}
  • account_info es el perfil: el correo es el campo en el que basarás la mayoría de las integraciones.
  • is_boarded es un booleano explícito (nunca falta), el mismo indicador que lee el dashboard para decidir si muestra la incorporación inicial.
  • drive_usage.quota_bytes / quota_unlimited es el mismo tope con el que se dibuja la barra de almacenamiento; quota_unlimited: true significa que no debes dar ningún sentido a quota_bytes para esa cuenta.
  • billing_status lleva todos los indicadores de bloqueo, suspensión y cancelación en un solo objeto. Todo lo que contiene es null (o 0) en una cuenta sana, así que un valor verdadero en cualquier parte de él es toda la señal que necesitas para detenerte y mostrar un mensaje de facturación en lugar de continuar.

Errores

Consulta Errores para ver los códigos que comparten todos los métodos.

Siguiente