Códigos de erro da GenderAPI

Contrato da resposta

Leia o objeto de erro

Quando uma solicitação falha, a resposta JSON devolve status como false. Use o errno numérico na lógica da aplicação e mantenha errmsg em logs ou diagnósticos legíveis.

JSON · erro de exemplo

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

Regra de implementação: tome decisões pelo errno, não pelo texto exato de errmsg. Assim, a integração continua previsível caso a mensagem explicativa mude.

Referência completa

Os valores abaixo correspondem à documentação pública atual da GenderAPI. Corrija a causa antes de repetir a solicitação.

errno50

access denied

A solicitação veio de um endereço IP ou referenciador não autorizado.

Revise as restrições de acesso configuradas para a chave da API.

errno90

invalid country code

O valor de país não é um código ISO 3166-1 alfa-2 aceito.

Valide e normalize o código do país antes de tentar novamente.

errno91

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

A solicitação não contém o parâmetro obrigatório name, email ou username.

Adicione a entrada obrigatória do endpoint chamado.

errno92

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

A solicitação excede o limite do lote: 100 nomes, 50 e-mails ou 50 nomes de usuário.

Divida a entrada em lotes menores e envie-os separadamente.

errno93

query limit reached

A chave da API não tem créditos restantes.

Pause as tarefas de consulta e reponha o saldo da conta.

errno94

invalid or missing key

A chave da API está ausente ou não foi encontrada.

Verifique a injeção da credencial e use uma chave válida no servidor.

errno99

API key has expired

O pacote associado à chave da API expirou.

Renove o pacote antes de enviar outra consulta.

Orientação de tratamento

Falhe com segurança e evite novas tentativas cegas

Valide primeiro

Rejeite entradas ausentes, códigos de país inválidos e lotes excessivos antes que cheguem à API.

Proteja as credenciais

Mantenha as chaves da API no servidor e oculte-as de logs da aplicação, saídas do navegador e capturas de tela de suporte.

Tente novamente de forma seletiva

Esses erros exigem uma correção ou ação na conta. Repetir a mesma solicitação sem alterações não irá resolvê-los.

TypeScript · validação da resposta

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

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

Mantenha os detalhes de diagnóstico privados

Registre o número do erro com um identificador interno da solicitação, mas nunca inclua a chave da API. Mostre uma mensagem curta e acionável sem expor credenciais ou dados internos.

Documentação concluída

Continue desenvolvendo com a GenderAPI

Uso e cotaMonitore os créditos disponíveis →PreçosCompare os pacotes de créditos →

Trate erros da API com segurança

Leia o objeto de erro