GenderAPI
Vaihda kieli22
KirjauduAloita
Valikko

Virheviite

Käsittele API-virheitä ennakoitavasti

Tunnista epäonnistuneet GenderAPI-pyynnöt vakaan errno-arvon avulla ja valitse oikea korjaustoimenpide.

Tarkista ensinstatus: falseerrnoerrmsg

Virhevastauksen rakenne

Lue virheobjekti

Kun pyyntö epäonnistuu, JSON-vastaus palauttaa status-arvoksi false. Käytä numeeristaerrno-arvoa sovelluslogiikassa ja säilytä errmsg lokeja tai luettavaa diagnostiikkaa varten.

JSON · virhe-esimerkki
{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}
Toteutussääntö: Ohjaa logiikkaa errno-arvon, ei errmsg-kentän tarkan tekstin perusteella. Näin integraatio pysyy ennakoitavana, vaikka seliteteksti myöhemmin muuttuisi.

Täydellinen viite

GenderAPI-virhekoodit

Alla olevat arvot vastaavat nykyistä julkista GenderAPI-dokumentaatiota. Korjaa syy ennen pyynnön lähettämistä uudelleen.

errno50
access denied

Pyyntö saapui IP-osoitteesta tai viittaajalta, jolla ei ole käyttöoikeutta.

Tarkista API-avaimeen liitetyt käyttörajoitukset.
errno90
invalid country code

Maa-arvo ei ole tuettu ISO 3166-1 alpha-2 -koodi.

Validoi ja normalisoi maakoodi ennen uutta yritystä.
errno91
name not set || email not set || username not set

Pyynnöstä puuttuu pakollinen nimi-, sähköposti- tai käyttäjänimiparametri.

Lisää kutsuttavan endpointin edellyttämä syöte.
errno92
too many names || too many emails || too many usernames

Pyyntö ylittää rajan: 100 nimeä, 50 sähköpostiosoitetta tai 50 käyttäjänimeä.

Jaa syötteet pienempiin eriin ja lähetä ne erikseen.
errno93
query limit reached

API-avaimella ei ole jäljellä krediittejä.

Keskeytä hakutyöt ja lisää krediittejä tilille.
errno94
invalid or missing key

API-avain puuttuu tai sitä ei löytynyt.

Tarkista avaimen välitys ja käytä kelvollista avainta palvelimella.
errno99
API key has expired

API-avaimeen liitetty paketti on vanhentunut.

Uusi paketti ennen uuden haun lähettämistä.

Virheenkäsittelyn ohjeistus

Epäonnistu turvallisesti ja vältä sokeita uudelleenyrityksiä

01

Validoi ensin

Hylkää puuttuvat syötteet, virheelliset maakoodit ja liian suuret erät ennen API-kutsua.

02

Suojaa API-avaimet

Säilytä API-avaimet palvelimella ja poista ne sovelluslokeista, selaimen tulosteista sekä asiakastuelle lähetettävistä kuvakaappauksista.

03

Yritä uudelleen valikoivasti

Nämä virheet edellyttävät korjausta tai tilitoimenpidettä. Saman muuttamattoman pyynnön toistaminen ei ratkaise ongelmaa.

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

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

Pidä diagnostiikkatiedot yksityisinä

Kirjaa virhenumero sisäisen pyyntötunnuksen kanssa, mutta älä koskaan API-avainta. Näytä käyttäjälle lyhyt ja toimintaan ohjaava viesti paljastamatta avaimia tai sisäisiä pyyntötietoja.

Dokumentaatio on valmis

Jatka rakentamista GenderAPIlla

Käyttö ja kiintiöSeuraa käytettävissä olevia krediittejä →HinnatVertaile krediittipaketteja →