Codes d’erreur GenderAPI

Structure de la réponse

Interprétez l’objet d’erreur

Lorsqu’une requête échoue, la réponse JSON renvoie status à false. Utilisez la valeur numérique errno pour la logique applicative et conservez errmsg pour les journaux ou diagnostics lisibles.

JSON · Exemple d’erreur

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

Règle d’implémentation : Construisez vos conditions à partir de errno, pas du texte exact de errmsg. L’intégration restera stable si le message explicatif évolue.

Référence complète

Ces valeurs correspondent à la documentation technique actuelle. Corrigez la cause avant de répéter une requête.

errno50

access denied

La requête provient d’une adresse IP ou d’un référent non autorisé.

Vérifiez les restrictions d’accès associées à la clé API.

errno90

invalid country code

La valeur country n’est pas un code ISO 3166-1 alpha-2 pris en charge.

Validez et normalisez le code pays avant de réessayer.

errno91

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

Le paramètre obligatoire name, email ou username est absent de la requête.

Ajoutez l’entrée requise par l’endpoint utilisé.

errno92

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

La requête dépasse la limite groupée : 100 prénoms, 50 e-mails ou 50 noms d’utilisateur.

Découpez les données en lots plus petits et envoyez-les séparément.

errno93

query limit reached

La clé API ne dispose plus de crédits disponibles.

Suspendez les requêtes et ajoutez des crédits au solde du compte.

errno94

invalid or missing key

La clé API est absente ou introuvable.

Vérifiez l’injection des identifiants et utilisez une clé valide côté serveur.

errno99

API key has expired

Le pack associé à la clé API a expiré.

Renouvelez le pack avant d’envoyer une nouvelle requête.

Recommandations de gestion

Échouez proprement et évitez les tentatives aveugles

Validez en amont

Rejetez les entrées vides, les pays non valides et les lots trop volumineux avant l’appel API.

Protégez les identifiants

Conservez les clés API côté serveur et retirez-les des journaux, réponses navigateur et captures d’assistance.

Réessayez sélectivement

Ces erreurs exigent une correction des données ou une action sur le compte. Répéter la même requête sans changement ne les résoudra pas.

TypeScript · Contrôle de réponse

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

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

Gardez les données de diagnostic confidentielles

Enregistrez le numéro d’erreur avec un identifiant de requête interne, mais jamais la clé API. Affichez à l’utilisateur un message court et utile sans révéler d’identifiants ni de détails internes.

Documentation terminée

Poursuivez votre intégration GenderAPI

Utilisation et quotaSuivre les crédits disponibles →TarifsComparer les packs de crédits →

Gérez les erreurs de l’API avec confiance

Interprétez l’objet d’erreur