Saldo Crediti

Name: SRTGen
Rating: 4.9 (10000 reviews)

Interroga il tuo saldo crediti disponibile attuale per gestire l'utilizzo e prevenire fallimenti dei lavori.

GET/api/v1/balance

Implementazione Rapida

curl -X GET https://api.srtgen.com/api/v1/balance \
  -H "x-api-key: <YOUR_API_KEY>"

GEThttps://api.srtgen.com/api/v1/balance

Questo endpoint restituisce il saldo totale utilizzabile, che include sia le indennità dell'abbonamento mensile che eventuali crediti di ricarica extra acquistati.

Struttura della Risposta

Parametro	Tipo	Richiesto
Identità e Contesto
`user`	Oggetto	Informazioni di base sull'utente autenticato.
`user.name`	Tipo	Il nome visualizzato dell'utente.
`user.email`	Tipo	L'indirizzo e-mail registrato.
Dettaglio Saldo Crediti
`credits`	Oggetto	Dettaglio dettagliato del saldo crediti.
`credits.totalBalance`	Number	Somma di tutti i crediti utilizzabili (Indennità + Extra).
`credits.extraCredits`	Number	Crediti di ricarica permanenti.
`credits.plans`	Array	Lista degli abbonamenti attivi.
`plans[].name`	Tipo	Nome visualizzato del piano (es. 'Piano Pro').
`plans[].status`	Tipo	Stato dell'abbonamento (active, past_due).
`plans[].balance`	Number	Crediti rimanenti in questo ciclo specifico.
Utilizzo Archiviazione Cloud
`storage`	Oggetto	Statistiche di utilizzo dell'archiviazione cloud.
`storage.usage`	Number	Utilizzo attuale dell'archiviazione in byte.
`storage.limit`	Number	Limite massimo di archiviazione in byte basato sul tuo piano.
`storage.formattedUsage`	Tipo	Utilizzo leggibile dall'uomo (es. '200 MB').
`storage.formattedLimit`	Tipo	Limite leggibile dall'uomo (es. '10 GB').

Esempio Risposta: 200 OK

{
  "success": true,
  "user": {
    "name": "Alex Rivera",
    "email": "[email protected]"
  },
  "credits": {
    "totalBalance": 1250,
    "totalMonthlyCredits": 1000,
    "extraCredits": 250,
    "plans": [
      {
        "id": "starter",
        "name": "Starter Plan",
        "status": "active",
        "balance": 1000,
        "total": 1000,
        "resetTime": "2026-04-29T17:48:46.000Z"
      }
    ]
  },
  "storage": {
    "usage": 209715200,
    "limit": 10737418240,
    "formattedUsage": "200 MB",
    "formattedLimit": "10 GB"
  },
  "updatedAt": "2026-03-29T17:48:46.000Z"
}

Errori

Stato	Codice Errore	Descrizione
401	unauthorized	Chiave API mancante o non valida.
500	server_error	Si è verificato un errore interno imprevisto.

Questa pagina è stata utile?