Monitoraggio dell’utilizzo

Controlla utilizzo e crediti rimanenti

Verifica il saldo GenderAPI e la scadenza del pacchetto prima che l’esaurimento della quota interrompa un flusso.

GEThttps://api.genderapi.io/api/remaining

Panoramica della quota

Controlla la capacità prima dell’elaborazione

Usa l’endpoint dei crediti rimanenti in processi di monitoraggio, dashboard interne o flussi batch. Restituisce una risposta compatta senza eseguire alcuna ricerca del genere.

Crediti rimanenti9.443Richieste disponibili
Stato del pacchetto AttivoIn base alla risposta di esempio
Scadenza1752651601Timestamp UNIX
GET

Endpoint dei crediti rimanenti

Recupera le informazioni sulla quota

Aggiungi la chiave API come parametro di query key. Esegui la richiesta lato server per non esporre la credenziale ai visitatori.

https://api.genderapi.io/api/remaining?key=YOUR_API_KEY
cURL
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"
Sicurezza delle credenziali: non chiamare questo endpoint direttamente da JavaScript pubblico nel browser. Eseguilo da un backend, un processo pianificato o una funzione server protetta.

Risposta di esempio

Saldo e scadenza

JSON
{
  "status": true,
  "remaining": 9443,
  "expiresAt": 1752651601
}

Campi della risposta

CampoTipoDescrizione
statusbooleantrue quando la richiesta riesce e la chiave API è valida.
remainingintegerNumero di crediti API attualmente disponibili.
expiresAtintegerScadenza del pacchetto espressa come timestamp UNIX in secondi.

Indicazioni operative

Crea un monitoraggio che intervenga in anticipo

01

Mostra la capacità disponibile

Visualizza il saldo in una dashboard interna per i team operativi e di assistenza.

02

Imposta soglie di avviso

Invia un avviso prima che il saldo raggiunga zero, lasciando il tempo di aggiungere crediti.

03

Proteggi i flussi batch

Confronta i crediti disponibili con la dimensione del batch pianificato prima di avviare il processo.

Esempio di criteri per gli avvisi

Scegli soglie adatte al tuo traffico invece di usare un unico valore universale.

  1. RegolarePiù del 20% disponibile
  2. AttenzioneDal 10% al 20% disponibile
  3. CriticoMeno del 10% disponibile

Pianifica la gestione della quota esaurita

Non aspettare un errore API per scoprire che il saldo è terminato. Esegui controlli a intervalli sensati, evita di verificare la quota prima di ogni singola richiesta e definisci come sospendere o riprovare il lavoro.

Riferimento successivo

Gestisci gli errori API

Codici di erroreGestisci gli errori in modo prevedibile →PrezziConfronta i pacchetti di crediti →