Statut du compte
Renvoie le solde de crédits et l'abonnement du compte porté par votre clé API. Lecture pure : rien n'est débité.
/api/v1/accountGratuitC'est l'endpoint à appeler avant une série de générations, ou au réveil d'un workflow planifié : il dit en un aller-retour combien il vous reste et si votre abonnement tient toujours. Aucun paramètre, aucun corps de requête — seule votre clé décide de ce qui est renvoyé.
Le seul endpoint appelable à 0 crédit
402dès que le solde tombe à zéro. Celle-ci reste ouverte : l'endpoint qui vous annonce « plus de crédits » serait bien inutile s'il était le premier à se fermer.En-têtes
En-têtes de la requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
Authorization | string | Requis | Votre clé API, préfixée de Bearer. Une clé absente, inconnue ou révoquée donne un 401. |
Exemple
curl -s https://subreply.io/api/v1/account \
-H "Authorization: Bearer sr_live_VOTRE_CLE_API"{
"credits": {
"monthly_remaining": 320,
"purchased_remaining": 150,
"total_remaining": 470
},
"subscription": {
"status": "active",
"plan": "starter"
}
}{
"credits": {
"monthly_remaining": 0,
"purchased_remaining": 0,
"total_remaining": 0
},
"subscription": {
"status": "none",
"plan": null
}
}Champs de la réponse
| Champ | Type | Description |
|---|---|---|
credits.monthly_remaining | number | Crédits du mois en cours encore disponibles. Ils sont renouvelés à chaque période d'abonnement et ne se reportent pas. |
credits.purchased_remaining | number | Crédits achetés à l'unité encore disponibles. Ils n'expirent pas. |
credits.total_remaining | number | Somme des deux. C'est ce total que les routes de production comparent au coût d'un appel. |
subscription.status | string | État de l'abonnement (voir le tableau ci-dessous). |
subscription.plan | string | null | Nom du plan, ou null si le compte n'a jamais souscrit. Un seul plan existe aujourd'hui. |
La réponse ne contient ni e-mail, ni identifiant Stripe, ni identifiant de compte : une clé API dit ce qu'elle peut faire, pas qui la porte.
Statuts d'abonnement
| Statut | Ce qu'il veut dire |
|---|---|
active | Abonnement payant en cours. |
past_due | Un paiement a échoué. L'abonnement n'est pas encore résilié, mais il faut mettre à jour le moyen de paiement. |
canceled | Abonnement résilié. Les crédits achetés restent utilisables, les crédits mensuels ne sont plus renouvelés. |
none | Aucun abonnement n'a jamais été souscrit sur ce compte. |
Erreurs
Deux cas seulement : 401 si la clé est absente ou invalide et 503 si le solde n'a pas pu être lu. Un 503 ne veut pas dire « compte vide » mais « solde indisponible » : réessayez plutôt que de conclure. Le détail est sur la page codes d'erreur.