Siirry sisältöön
Tarkistettu

Lue kirjautunut tili

Hae sama tilitietue, jonka koontinäytön sivun lataus lukee, yhdellä kutsulla ja ilman kenttiä.

get_account_info on sama kutsu, jonka koontinäyttö tekee jokaisella sivun latauksella: ei parametreja valtuutesi lisäksi, yksi tilitietue takaisin, joka kattaa paketin, käytön, tallennustilan ja laskutustilan yhdellä edestakaisella kierrolla. Käytä sitä aina, kun oma taustajärjestelmäsi tarvitsee tietää, kenen kanssa se puhuu tai mikä paketti ja kiintiö tilillä on juuri nyt.

Metodi

POST/cpi/get_account_info
user

Get Account Info

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

Läpikäynti

Kutsu sitä pelkällä avaimellasi

get_account_info ei ilmoita omia kenttiä. Tili, jolle se vastaa, on se, jonka valtuutesi todentaa: tilin tai projektin laajuinen API-avain rungossa tai kirjautuneen kävijän xu-gtp-token-otsake, jos kutsut tätä selaimen istunnosta.

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

Vastaus

data on tilidokumentti, typistettynä siihen, mitä asiakkaan pitäisi lukea. Alla olevat kentät ovat oikeat avaimet, joista get_account_data rakentaa vastauksen, ei näyte isommasta tuntemattomasta muodosta:

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 on profiili: sähköposti on kenttä, jonka mukaan useimmat integraatiot avaimistavat.
  • is_boarded on nimenomainen totuusarvo (ei koskaan puuttuva), sama lippu, jonka koontinäyttö lukee päättääkseen, näytetäänkö käyttöönotto.
  • drive_usage.quota_bytes / quota_unlimited on sama katto, josta tallennustilapalkki piirtyy; quota_unlimited: true tarkoittaa, ettei quota_bytes:lle kyseisellä tilillä pidä antaa merkitystä.
  • billing_status kantaa jokaisen pidätys-, keskeytys- ja lopetuslipun yhtenä objektina. Kaikki siinä on null (tai 0) terveellä tilillä, joten tosi arvo missä tahansa siinä on koko signaali, jonka tarvitset pysähtyäksesi ja näyttääksesi laskutusviestin jatkamisen sijaan.

Virheet

Katso Virheet kaikille metodeille yhteiset koodit.

Seuraavaksi