GenderAPI
Taal wijzigen22
InloggenGratis beginnen
Menu

Foutreferentie

Verwerk API-fouten betrouwbaar

Herken mislukte GenderAPI-aanvragen aan hun stabiele errno-waarde en voer daarna de juiste correctie uit.

Controleer eerststatus: falseerrnoerrmsg

Responscontract

Lees het foutobject

Wanneer een aanvraag mislukt, retourneert de JSON-respons status als false. Gebruik de numeriekeerrno voor applicatielogica en bewaar errmsg voor logs of leesbare diagnostiek.

JSON · voorbeeldfout
{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}
Implementatieregel: Baseer vertakkingen op errno, niet op de exacte tekst van errmsg. Zo blijft je integratie voorspelbaar wanneer de toelichting later verandert.

Volledige referentie

GenderAPI-foutcodes

De volgende waarden komen overeen met de actuele openbare GenderAPI-documentatie. Verhelp de oorzaak voordat je een aanvraag opnieuw verstuurt.

errno50
access denied

De aanvraag kwam van een niet-geautoriseerd IP-adres of een niet-toegestane verwijzende website.

Controleer de toegangsbeperkingen die aan de API-sleutel zijn gekoppeld.
errno90
invalid country code

De landwaarde is geen ondersteunde ISO 3166-1 alpha-2-code.

Valideer en normaliseer de landcode voordat je het opnieuw probeert.
errno91
name not set || email not set || username not set

De verplichte parameter name, email of username ontbreekt in de aanvraag.

Voeg de verplichte invoer toe voor het endpoint dat je aanroept.
errno92
too many names || too many emails || too many usernames

De aanvraag overschrijdt de batchlimiet: 100 namen, 50 e-mails of 50 gebruikersnamen.

Verdeel de invoer over kleinere batches en verstuur deze afzonderlijk.
errno93
query limit reached

De API-sleutel heeft geen resterende credits.

Pauzeer querytaken en vul het accountsaldo aan.
errno94
invalid or missing key

De API-sleutel ontbreekt of kan niet worden gevonden.

Controleer hoe de sleutel wordt ingevoegd en gebruik server-side een geldige sleutel.
errno99
API key has expired

Het pakket dat aan de API-sleutel is gekoppeld, is verlopen.

Verleng het pakket voordat je een nieuwe query verstuurt.

Advies voor foutafhandeling

Stop veilig en voorkom blinde herhaalpogingen

01

Valideer vooraf

Weiger ontbrekende invoer, ongeldige landcodes en te grote batches voordat ze de API bereiken.

02

Bescherm API-sleutels

Bewaar API-sleutels op de server en verwijder ze uit applicatielogs, browseruitvoer en support- screenshots.

03

Herhaal selectief

Deze fouten vereisen een correctie of accountactie. Dezelfde aanvraag ongewijzigd herhalen lost ze niet op.

TypeScript · responscontrole
type GenderApiError = {
  status: false;
  errno: number;
  errmsg: string;
};

if (response.status === false) {
  handleGenderApiError(response.errno, response.errmsg);
}

Houd diagnostische gegevens privé

Log het foutnummer met een interne aanvraag-ID, maar neem nooit de API-sleutel op. Toon gebruikers een beknopte, bruikbare melding in plaats van ruwe sleutels of interne aanvraaggegevens vrij te geven.

Documentatie voltooid

Bouw verder met GenderAPI

Gebruik en quotaBewaak beschikbare credits →PrijzenVergelijk creditpakketten →