Uso & Cota
A plataforma GenderAPI permite que você verifique o saldo atual de créditos da sua conta a qualquer momento através de um endpoint dedicado. Isso ajuda você a monitorar o uso e evitar interrupções inesperadas ao executar operações em grande volume.
✅ Verificar seus créditos restantes
Você pode obter informações sobre a sua cota atual utilizando o seguinte endpoint:
GET https://api.genderapi.io/api/remaining?key=YOUR_API_KEYExemplo de requisição com curl:
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"✅ Exemplo de resposta
A API retorna um objeto JSON:
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
| status | Boolean | Indica se a requisição foi bem-sucedida. Retorna true se a sua chave de API for válida. |
| remaining | Integer | Quantidade de créditos de API restantes na sua conta. |
| expiresAt | Integer (timestamp) | Timestamp Unix indicando quando o seu pacote atual de créditos expira. |
Casos de uso
- Exibir informações atuais da cota na interface do seu painel.
- Gerar alertas quando seus créditos caírem abaixo de um determinado limite.
- Integrar com ferramentas de cobrança ou monitoramento para evitar interrupções no serviço.
Importante:
Sempre monitore seus créditos restantes para evitar erros inesperados causados pelo esgotamento da cota. Scripts de alto volume ou automatizados devem verificar periodicamente o seu status de uso.