Struttura della risposta
Leggi l’oggetto di errore
Quando una richiesta non riesce, la risposta JSON restituisce status con valore false. Usa il valore numerico errno nella logica applicativa e conserva errmsg per i log o una diagnostica leggibile.
{
"status": false,
"errno": 94,
"errmsg": "invalid or missing key"
}errno, non sul testo esatto di errmsg. L’integrazione rimarrà prevedibile anche se il messaggio descrittivo cambierà.Riferimento completo
Codici di errore GenderAPI
I valori seguenti corrispondono alla documentazione pubblica corrente di GenderAPI. Correggi la causa prima di ripetere una richiesta.
access deniedLa richiesta proviene da un indirizzo IP o referrer non autorizzato.
invalid country codeIl valore country non è un codice ISO 3166-1 alpha-2 supportato.
name not set || email not set || username not setNella richiesta manca il parametro obbligatorio name, email oppure username.
too many names || too many emails || too many usernamesLa richiesta supera il limite batch: 100 nomi, 50 email oppure 50 username.
query limit reachedLa chiave API non dispone più di crediti.
invalid or missing keyLa chiave API manca oppure non è stata trovata.
API key has expiredIl pacchetto associato alla chiave API è scaduto.
Indicazioni per la gestione
Gestisci gli errori in sicurezza ed evita retry inutili
Valida prima della richiesta
Blocca input mancanti, codici paese non validi e batch troppo grandi prima che raggiungano l’API.
Proteggi le credenziali
Mantieni le chiavi API sul server e rimuovile da log, output del browser e schermate inviate all’assistenza.
Ripeti solo quando serve
Questi errori richiedono una correzione o un intervento sull’account. Ripetere la stessa richiesta senza modifiche non li risolverà.
type GenderApiError = {
status: false;
errno: number;
errmsg: string;
};
if (response.status === false) {
handleGenderApiError(response.errno, response.errmsg);
}Mantieni private le informazioni diagnostiche
Registra il numero di errore insieme a un identificatore interno della richiesta, ma non includere mai la chiave API. Mostra agli utenti un messaggio breve e utile senza esporre credenziali o dati interni.
Documentazione completata