GenderAPI
Změnit jazyk22
Přihlásit seZačít zdarma
Menu

Přehled chyb

Zpracovávejte chyby API spolehlivě

Neúspěšné požadavky GenderAPI rozpoznávejte podle stabilní hodnoty errno a zvolte správnou nápravu.

Zkontrolujte nejdřívestatus: falseerrnoerrmsg

Smlouva odpovědi

Čtení chybového objektu

Při neúspěšném požadavku vrátí odpověď JSON hodnotu status nastavenou na false. Pro logiku aplikace používejte číselné errno; errmsg ponechte pro protokoly nebo srozumitelnou diagnostiku.

JSON · příklad chyby
{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}
Pravidlo implementace: Rozhodujte podle errno, nikoli podle přesného znění errmsg. Integrace tak zůstane předvídatelná, i když se vysvětlující text později změní.

Úplný přehled

Chybové kódy GenderAPI

Následující hodnoty odpovídají aktuální veřejné dokumentaci GenderAPI. Před opakováním požadavku odstraňte příčinu.

errno50
access denied

Požadavek přišel z nepovolené IP adresy nebo refereru.

Zkontrolujte omezení přístupu přiřazená k API klíči.
errno90
invalid country code

Hodnota země není podporovaný kód ISO 3166-1 alpha-2.

Před opakováním požadavku ověřte a normalizujte kód země.
errno91
name not set || email not set || username not set

V požadavku chybí povinný parametr name, email nebo username.

Doplňte povinný vstup pro volaný endpoint.
errno92
too many names || too many emails || too many usernames

Požadavek překračuje dávkový limit: 100 jmen, 50 e-mailů nebo 50 uživatelských jmen.

Rozdělte vstup na menší dávky a odešlete je samostatně.
errno93
query limit reached

API klíč nemá žádné zbývající kredity.

Pozastavte úlohy s dotazy a doplňte zůstatek účtu.
errno94
invalid or missing key

API klíč chybí nebo jej nelze najít.

Zkontrolujte vložení přihlašovacího údaje a použijte platný serverový klíč.
errno99
API key has expired

Platnost balíčku spojeného s API klíčem vypršela.

Před odesláním dalšího dotazu balíček obnovte.

Doporučení ke zpracování

Selhávejte bezpečně a neopakujte požadavky naslepo

01

Nejprve ověřujte

Chybějící vstupy, neplatné kódy zemí a příliš velké dávky odmítněte ještě před odesláním do API.

02

Chraňte přihlašovací údaje

API klíče uchovávejte na serveru a odstraňujte je z aplikačních protokolů, výstupu prohlížeče i snímků obrazovky pro podporu.

03

Opakujte selektivně

Tyto chyby vyžadují opravu požadavku nebo zásah v účtu. Nezměněný požadavek problém nevyřeší.

TypeScript · kontrola odpovědi
type GenderApiError = {
  status: false;
  errno: number;
  errmsg: string;
};

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

Diagnostické údaje ponechte soukromé

Chybové číslo zaznamenejte s interním identifikátorem požadavku, nikdy však s API klíčem. Uživatelům zobrazte stručnou a použitelnou zprávu místo nezpracovaných přihlašovacích údajů nebo interních dat.

Dokumentace dokončena

Pokračujte ve vývoji s GenderAPI

Využití a kvótaSledujte dostupné kredity →CeníkPorovnejte kreditní balíčky →