Endpoints

Accountstatus

Geeft het creditsaldo en het abonnement terug van het account achter je API-sleutel. Puur lezen: er wordt niets afgeschreven.

GET/api/v1/accountGratis

Dit is het endpoint dat je aanroept vóór een reeks generaties, of zodra een geplande workflow wakker wordt: één rondje vertelt je hoeveel je nog hebt en of je abonnement nog loopt. Geen parameters, geen request body — alleen je sleutel bepaalt wat je terugkrijgt.

Het enige endpoint dat werkt bij 0 credits

De drie productieroutes antwoorden 402zodra het saldo op nul staat. Dit endpoint blijft open: uitgerekend het endpoint dat meldt « geen credits meer » zou nutteloos zijn als het als eerste dichtging.

Headers

Headers van de aanvraag

Parameter	Type	Verplicht	Beschrijving
`Authorization`	`string`	Verplicht	Je API-sleutel, voorafgegaan door `Bearer`. Een ontbrekende, onbekende of ingetrokken sleutel geeft een `401`.

Voorbeeld

cURL

curl -s https://subreply.io/api/v1/account \
  -H "Authorization: Bearer sr_live_UW_API_SLEUTEL"

Antwoord 200

{
  "credits": {
    "monthly_remaining": 320,
    "purchased_remaining": 150,
    "total_remaining": 470
  },
  "subscription": {
    "status": "active",
    "plan": "starter"
  }
}

Account zonder abonnement

{
  "credits": {
    "monthly_remaining": 0,
    "purchased_remaining": 0,
    "total_remaining": 0
  },
  "subscription": {
    "status": "none",
    "plan": null
  }
}

Velden van het antwoord

Veld	Type	Beschrijving
`credits.monthly_remaining`	number	Credits van de lopende maand die nog beschikbaar zijn. Ze worden elke abonnementsperiode vernieuwd en schuiven niet door.
`credits.purchased_remaining`	number	Los gekochte credits die nog beschikbaar zijn. Die verlopen niet.
`credits.total_remaining`	number	De som van beide. Dit totaal leggen de productieroutes naast de kosten van een aanroep.
`subscription.status`	string	Staat van het abonnement (zie de tabel hieronder).
`subscription.plan`	string \| null	Naam van het plan, of null als het account nooit een abonnement nam. Er bestaat vandaag één plan.

Het antwoord bevat geen e-mailadres, geen Stripe-identificatie en geen account-id: een API-sleutel zegt wat ze mag doen, niet wie ze toebehoort.

Abonnementsstatussen

Status	Wat het betekent
`active`	Betaald abonnement loopt.
`past_due`	Een betaling is mislukt. Het abonnement is nog niet opgezegd, maar de betaalmethode moet worden bijgewerkt.
`canceled`	Abonnement opgezegd. Gekochte credits blijven bruikbaar, maandcredits worden niet meer vernieuwd.
`none`	Dit account nam nooit een abonnement.

Fouten

Slechts twee gevallen: 401 als de sleutel ontbreekt of ongeldig is, en 503 als het saldo niet gelezen kon worden. Een 503betekent niet « leeg account » maar « saldo niet beschikbaar »: probeer opnieuw in plaats van conclusies te trekken. De details staan op de pagina foutcodes.