Códigos de Error de GenderAPI

Estructura de la respuesta

Interpreta el objeto de error

Cuando una solicitud falla, la respuesta JSON devuelve status como false. Utiliza el valor numérico errno para la lógica de la aplicación y conserva errmsg para logs o diagnósticos legibles.

JSON · error de ejemplo

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

Regla de implementación: Crea las condiciones mediante errno, no mediante el texto exacto de errmsg. La integración seguirá siendo estable aunque cambie el texto explicativo.

Referencia completa

Estos valores corresponden con la documentación actual de GenderAPI. Corrige la causa antes de repetir una solicitud.

errno50

access denied

La solicitud procede de una dirección IP o referente no autorizado.

Revisa las restricciones de acceso asignadas a la clave API.

errno90

invalid country code

El valor country no es un código ISO 3166-1 alfa-2 compatible.

Valida y normaliza el código de país antes de reintentar.

errno91

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

Falta el parámetro obligatorio name, email o username en la solicitud.

Añade la entrada que necesita el endpoint utilizado.

errno92

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

La solicitud supera el límite por lotes: 100 nombres, 50 emails o 50 usuarios.

Divide los datos en lotes menores y envíalos por separado.

errno93

query limit reached

La clave API no tiene créditos disponibles.

Pausa las consultas y añade créditos al saldo de la cuenta.

errno94

invalid or missing key

La clave API no está incluida o no se encuentra.

Comprueba la inyección de credenciales y utiliza una clave válida desde el servidor.

errno99

API key has expired

El paquete asociado con la clave API ha vencido.

Renueva el paquete antes de enviar otra consulta.

Recomendaciones de gestión

Falla de forma segura y evita reintentos ciegos

Valida primero

Rechaza entradas vacías, países no válidos y lotes demasiado grandes antes de enviarlos a la API.

Protege las credenciales

Conserva las claves API en el servidor y elimínalas de logs, respuestas del navegador y capturas de soporte.

Reintenta de forma selectiva

Estos errores requieren corregir datos o actuar en la cuenta. Repetir la misma solicitud sin cambios no los resolverá.

TypeScript · control de respuesta

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

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

Mantén privados los datos de diagnóstico

Registra el número de error con un identificador interno de solicitud, pero nunca incluyas la clave API. Muestra al usuario un mensaje breve y útil sin revelar credenciales ni datos internos.

Documentación completada

Continúa desarrollando con GenderAPI

Uso y cuotaControla los créditos disponibles →PreciosCompara los paquetes de créditos →

Gestiona los errores de la API con confianza

Interpreta el objeto de error