GenderAPI Fehlercodes | errno-Dokumentation

Antwortstruktur

Fehlerobjekt auswerten

Bei einer fehlgeschlagenen Anfrage enthält die JSON-Antwort status: false. Verwenden Sie die numerische Eigenschaft errno für die Anwendungslogik und errmsg für Logs oder verständliche Diagnosen.

JSON · Fehlerbeispiel

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

Implementierungsregel: Verzweigen Sie anhand von errno, nicht anhand des exakten Wortlauts von errmsg. So bleibt die Integration stabil, wenn sich ein Erklärungstext ändert.

Vollständige Liste

GenderAPI-Fehlercodes

Die folgenden Werte entsprechen der aktuellen öffentlichen GenderAPI-Dokumentation. Beheben Sie die Ursache, bevor Sie die Anfrage wiederholen.

errno50

access denied

Die Anfrage stammt von einer nicht autorisierten IP-Adresse oder einem nicht erlaubten Referrer.

Prüfen Sie die Zugriffsbeschränkungen des verwendeten API-Schlüssels.

errno90

invalid country code

Der Länderwert ist kein unterstützter ISO-3166-1-Alpha-2-Code.

Validieren und normalisieren Sie den Ländercode vor einem erneuten Versuch.

errno91

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

Der erforderliche Parameter name, email oder username fehlt.

Ergänzen Sie die für den aufgerufenen Endpunkt erforderliche Eingabe.

errno92

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

Die Anfrage überschreitet das Batch-Limit: 100 Namen, 50 E-Mail-Adressen oder 50 Benutzernamen.

Teilen Sie die Daten in kleinere Batches und senden Sie diese getrennt.

errno93

query limit reached

Für den API-Schlüssel sind keine Credits mehr verfügbar.

Pausieren Sie Jobs und laden Sie das Kontoguthaben auf.

errno94

invalid or missing key

Der API-Schlüssel fehlt oder wurde nicht gefunden.

Prüfen Sie die Übermittlung der Zugangsdaten und verwenden Sie serverseitig einen gültigen Schlüssel.

errno99

API key has expired

Das mit dem API-Schlüssel verknüpfte Paket ist abgelaufen.

Erneuern Sie das Paket, bevor Sie weitere Anfragen senden.

Behandlungsmuster

Sicher reagieren und blinde Wiederholungen vermeiden

Vor dem Senden validieren

Lehnen Sie fehlende Eingaben, ungültige Ländercodes und zu große Batches ab, bevor sie die API erreichen.

Zugangsdaten schützen

Speichern Sie API-Schlüssel serverseitig und entfernen Sie sie aus Logs, Browserantworten und Screenshots.

Selektiv wiederholen

Diese Fehler erfordern eine korrigierte Anfrage oder eine Kontoaktion. Eine unveränderte Wiederholung behebt sie nicht.

TypeScript · Antwortprüfung

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

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

Diagnosedetails nicht offenlegen

Protokollieren Sie die Fehlernummer zusammen mit einer internen Anfrage-ID, niemals jedoch mit dem API-Schlüssel. Zeigen Sie Nutzern eine kurze Handlungsanweisung statt roher Zugangsdaten oder interner Systeminformationen.

Dokumentation abgeschlossen

Mit GenderAPI weiterarbeiten

Nutzung und KontingentVerfügbare Credits überwachen →PreiseCredit-Pakete vergleichen →