GenderAPI felkoder | Referens för GenderAPI-fel

Svarskontrakt

Läs felobjektet

När en förfrågan misslyckas returnerar JSON-svaret status som false. Använd det numeriska errno i applikationslogiken och behåll errmsg för loggar eller läsbar diagnostik.

JSON · exempel på fel

{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}

Implementationsregel: Styr programflödet med errno, inte den exakta formuleringen i errmsg. Integrationen förblir då förutsägbar om förklaringstexten ändras senare.

Fullständig referens

GenderAPI-felkoder

Följande värden motsvarar den aktuella offentliga GenderAPI-dokumentationen. Åtgärda orsaken innan förfrågan upprepas.

errno50

access denied

Förfrågan kom från en IP-adress eller referrer som saknar behörighet.

Kontrollera åtkomstbegränsningarna som är kopplade till API-nyckeln.

errno90

invalid country code

Värdet för land är inte en giltig ISO 3166-1 alpha-2-kod som stöds.

Validera och normalisera landskoden innan du försöker igen.

errno91

name not set || email not set || username not set

Förfrågan saknar den obligatoriska parametern name, email eller username.

Lägg till den indata som krävs av endpointen du anropar.

errno92

too many names || too many emails || too many usernames

Förfrågan överskrider batchgränsen: 100 namn, 50 e-postadresser eller 50 användarnamn.

Dela indatan i mindre batcher och skicka dem separat.

errno93

query limit reached

API-nyckeln har inga krediter kvar.

Pausa uppslagningsjobben och fyll på kontots kreditbalans.

errno94

invalid or missing key

API-nyckeln saknas eller kan inte hittas.

Kontrollera hur autentiseringsuppgiften tillförs och använd en giltig nyckel på serversidan.

errno99

API key has expired

Paketet som är kopplat till API-nyckeln har upphört att gälla.

Förnya paketet innan du skickar en ny uppslagning.

Hanteringsprinciper

Misslyckas säkert och undvik blinda återförsök

Validera först

Avvisa saknad indata, ogiltiga landskoder och för stora batcher innan de når API:et.

Skydda autentiseringsuppgifter

Förvara API-nycklar på servern och maskera dem i applikationsloggar, webbläsarutdata och skärmbilder för support.

Försök igen selektivt

Dessa fel kräver korrigering eller en kontoåtgärd. Samma oförändrade förfrågan löser inte problemet.

TypeScript · svarskontroll

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

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

Håll diagnostiska uppgifter privata

Logga felnumret tillsammans med ett internt request-ID, men aldrig API-nyckeln. Visa användaren ett kort och handlingsinriktat meddelande i stället för råa autentiseringsuppgifter eller intern förfrågningsdata.

Dokumentationen är klar

Fortsätt bygga med GenderAPI

Användning och kvotÖvervaka tillgängliga krediter →PriserJämför kreditpaket →