Visão geral da cota
Verifique a capacidade antes do processamento
Use o endpoint de créditos restantes em rotinas de monitoramento, painéis internos ou fluxos em lote. Ele devolve uma resposta compacta sem realizar uma consulta de gênero.
Endpoint de créditos restantes
Consulte as informações da cota
Adicione sua chave de API no parâmetro de consulta key. Faça a solicitação no servidor para não expor a credencial aos visitantes.
https://api.genderapi.io/api/remaining?key=YOUR_API_KEYcurl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"Resposta de exemplo
Saldo e expiração
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
status | boolean | true quando a solicitação é concluída e a chave da API é válida. |
remaining | integer | Quantidade de créditos da API disponíveis no momento. |
expiresAt | integer | Expiração do pacote expressa como timestamp UNIX em segundos. |
Orientação operacional
Crie um monitoramento de cota preventivo
Mostre a capacidade atual
Exiba o saldo em um painel interno para as equipes de operações e suporte.
Defina limites de alerta
Emita um alerta antes que o saldo chegue a zero para haver tempo de repor os créditos.
Proteja os fluxos em lote
Compare os créditos disponíveis com o tamanho do lote planejado antes de iniciar a tarefa.
Use limites adequados ao seu tráfego, em vez de um único valor universal.
- SaudávelMais de 20% restantes
- Atenção10–20% restantes
- CríticoMenos de 10% restantes
Planeje-se para o fim da cota
Não espere um erro da API para descobrir que o saldo acabou. Monitore em intervalos adequados, evite consultar antes de cada chamada individual e defina como a aplicação deve pausar ou tentar novamente.
Próxima referência