Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Ανάγνωση του συνδεδεμένου λογαριασμού

Φέρτε την ίδια εγγραφή λογαριασμού που διαβάζει μια φόρτωση σελίδας του πίνακα ελέγχου, με μία κλήση και χωρίς πεδία.

Το get_account_info είναι η ίδια κλήση που κάνει ο πίνακας ελέγχου σε κάθε φόρτωση σελίδας: καμία παράμετρος πέρα από το διαπιστευτήριό σας, μία εγγραφή λογαριασμού πίσω, που καλύπτει πλάνο, χρήση, αποθηκευτικό χώρο και κατάσταση χρέωσης σε έναν μόνο γύρο. Χρησιμοποιήστε την όποτε το δικό σας backend πρέπει να ξέρει με ποιον μιλά, ή σε ποιο πλάνο και ποια ποσόστωση βρίσκεται ο λογαριασμός αυτή τη στιγμή.

Μέθοδος

POST/cpi/get_account_info
user

Get Account Info

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

Οδηγός βήμα προς βήμα

Καλέστε την μόνο με το κλειδί σας

Το get_account_info δεν δηλώνει δικά του πεδία. Ο λογαριασμός για τον οποίο απαντά είναι όποιος πιστοποιείται από το διαπιστευτήριό σας: ένα κλειδί API επιπέδου λογαριασμού ή έργου στο σώμα, ή το header xu-gtp-token ενός συνδεδεμένου επισκέπτη αν την καλείτε από συνεδρία 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'])

Η απάντηση

Το data είναι το έγγραφο λογαριασμού, περιορισμένο σε ό,τι πρέπει να διαβάζει ένας client. Τα πεδία παρακάτω είναι τα πραγματικά κλειδιά από τα οποία χτίζει την απάντηση το get_account_data, όχι δείγμα ενός μεγαλύτερου άγνωστου σχήματος:

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 είναι το προφίλ: το email είναι το πεδίο στο οποίο θα βασίσετε τις περισσότερες ενσωματώσεις.
  • Το is_boarded είναι ρητή τιμή boolean (δεν λείπει ποτέ), η ίδια σημαία που διαβάζει ο πίνακας ελέγχου για να αποφασίσει αν θα δείξει την εισαγωγή (onboarding).
  • Το drive_usage.quota_bytes / quota_unlimited είναι το ίδιο όριο από το οποίο σχεδιάζεται η μπάρα αποθηκευτικού χώρου: το quota_unlimited: true σημαίνει ότι δεν πρέπει να δίνετε καμία σημασία στο quota_bytes για αυτόν τον λογαριασμό.
  • Το billing_status φέρει κάθε σημαία αναστολής/αναμονής/τερματισμού ως ένα αντικείμενο. Όλα μέσα του είναι null (ή 0) σε έναν υγιή λογαριασμό, άρα μια αληθής τιμή οπουδήποτε εκεί είναι όλο το σήμα που χρειάζεστε για να σταματήσετε και να δείξετε ένα μήνυμα χρέωσης αντί να προχωρήσετε.

Σφάλματα

Δείτε τα Σφάλματα για τους κωδικούς που μοιράζονται όλες οι μέθοδοι.

Επόμενο