Control de uso

Controla el uso y los créditos restantes

Consulta el saldo actual y el vencimiento del paquete antes de que una cuota agotada interrumpa tu flujo.

GEThttps://api.genderapi.io/api/remaining

Resumen de la cuota

Comprueba la capacidad antes de procesar

Utiliza el endpoint de créditos restantes en tareas de monitorización, paneles internos o procesos por lotes. Devuelve una respuesta compacta sin realizar una consulta de género.

Créditos restantes9.443Consultas disponibles
Estado del paquete ActivoSegún la respuesta de ejemplo
Vence en1752651601Marca de tiempo UNIX
GET

Endpoint de créditos restantes

Obtén la información de cuota

Añade tu clave API como parámetro key. Ejecuta la solicitud desde el servidor para no exponer la credencial a los visitantes.

https://api.genderapi.io/api/remaining?key=YOUR_API_KEY
cURL
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"
Seguridad de credenciales: No llames a este endpoint desde JavaScript público en el navegador. Utiliza un backend, una tarea programada o una función protegida del servidor.

Respuesta de ejemplo

Saldo y vencimiento

JSON
{
  "status": true,
  "remaining": 9443,
  "expiresAt": 1752651601
}

Campos de respuesta

CampoTipoDescripción
statusbooleantrue cuando la solicitud funciona y la clave API es válida.
remainingintegerNúmero de créditos API disponibles actualmente.
expiresAtintegerVencimiento del paquete como marca de tiempo UNIX en segundos.

Recomendaciones operativas

Crea una monitorización que actúe a tiempo

01

Muestra la capacidad actual

Presenta el saldo en un panel interno para los equipos de operaciones y soporte.

02

Define umbrales de aviso

Avisa antes de que el saldo llegue a cero para disponer de tiempo para recargar créditos.

03

Protege los procesos por lotes

Compara los créditos disponibles con el tamaño del lote antes de iniciar el trabajo.

Ejemplo de política de alertas

Utiliza umbrales adaptados a tu tráfico en lugar de una cifra universal.

  1. SaludableMás del 20% restante
  2. AvisoEntre 10% y 20%
  3. CríticoMenos del 10%

Prepárate para agotar la cuota

No esperes a un error de la API para descubrir que el saldo se ha agotado. Compruébalo con una frecuencia razonable, evita hacerlo antes de cada consulta individual y define cómo debe pausar o reintentar el trabajo tu aplicación.

Siguiente referencia

Gestiona los errores de la API

Códigos de errorCrea un tratamiento de errores predecible →PreciosCompara los paquetes de créditos →