Sari la conținut
Verificat

Citește contul conectat

Preia aceeași înregistrare de cont pe care o citește o pagină de tablou de bord la încărcare, cu un singur apel și fără câmpuri.

get_account_info este același apel pe care îl face tabloul de bord la fiecare încărcare de pagină: niciun parametru în afară de credențialul tău, o singură înregistrare de cont returnată, care acoperă planul, consumul, spațiul de stocare și starea de facturare într-un singur drum dus-întors. Folosește-l oricând backendul tău trebuie să afle cu cine vorbește sau pe ce plan și cotă se află în prezent acel cont.

Metodă

POST/cpi/get_account_info
user

Get Account Info

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

Parcurgere

Apeleaz-o doar cu cheia ta

get_account_info nu declară câmpuri proprii. Contul pentru care răspunde este cel pe care îl autentifică credențialul tău, o cheie API de cont sau de proiect în corp, sau antetul xu-gtp-token al unui vizitator conectat, dacă o apelezi dintr-o sesiune de browser.

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'])

Răspunsul

data este documentul contului, redus la ce ar trebui să citească un client. Câmpurile de mai jos sunt cheile reale din care get_account_data construiește răspunsul, nu un eșantion dintr-o formă mai mare necunoscută:

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 este profilul: e-mailul este câmpul pe baza căruia vei lega cele mai multe integrări.
  • is_boarded este un boolean explicit (niciodată lipsă), același flag pe care îl citește tabloul de bord ca să decidă dacă afișează onboardingul.
  • drive_usage.quota_bytes / quota_unlimited este același plafon din care se desenează bara de stocare; quota_unlimited: true înseamnă că nu trebuie să dai niciun sens lui quota_bytes pentru acel cont.
  • billing_status poartă fiecare flag de blocare/suspendare/terminare într-un singur obiect. Totul din el este null (sau 0) pe un cont sănătos, așa că o valoare adevărată oriunde acolo este tot semnalul de care ai nevoie ca să te oprești și să afișezi un mesaj de facturare în loc să continui.

Erori

Vezi Erori pentru codurile comune tuturor metodelor.

Urmează