Suivi de l’utilisation

Suivez l’utilisation et les crédits restants

Consultez votre solde et l’expiration du pack avant qu’un quota épuisé n’interrompe votre traitement.

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

Vue d’ensemble du quota

Vérifiez la capacité avant le traitement

Utilisez l’endpoint de crédits restants dans vos outils de supervision, tableaux de bord internes ou traitements groupés. Il renvoie une réponse compacte sans effectuer de requête de genre.

Crédits restants9 443Requêtes disponibles
État du pack ActifD’après l’exemple de réponse
Expiration1752651601Horodatage UNIX
GET

Endpoint des crédits restants

Obtenez les informations de quota

Ajoutez votre clé API dans le paramètre key. Exécutez la requête côté serveur afin de ne pas exposer l’identifiant aux visiteurs.

https://api.genderapi.io/api/remaining?key=YOUR_API_KEY
cURL
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"
Sécurité des identifiants : N’appelez pas cet endpoint depuis du JavaScript public dans le navigateur. Utilisez un backend, une tâche planifiée ou une fonction serveur protégée.

Exemple de réponse

Solde et expiration

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

Champs de la réponse

ChampTypeDescription
statusbooleantrue lorsque la requête réussit et que la clé API est valide.
remainingintegerNombre de crédits API actuellement disponibles.
expiresAtintegerDate d’expiration du pack en secondes au format UNIX.

Recommandations opérationnelles

Mettez en place une supervision proactive

01

Affichez la capacité actuelle

Présentez le solde dans un tableau de bord interne destiné aux équipes d’exploitation et de support.

02

Définissez des seuils d’alerte

Avertissez avant que le solde n’atteigne zéro afin de disposer du temps nécessaire pour recharger les crédits.

03

Protégez les traitements groupés

Comparez les crédits disponibles à la taille du lot avant de démarrer le traitement.

Exemple de politique d’alerte

Adaptez les seuils à votre trafic plutôt que d’utiliser une valeur universelle.

  1. SainPlus de 20 % restants
  2. AvertissementEntre 10 % et 20 %
  3. CritiqueMoins de 10 %

Préparez-vous à l’épuisement du quota

N’attendez pas une erreur de l’API pour découvrir que le solde est épuisé. Vérifiez-le à une fréquence raisonnable, sans interroger l’endpoint avant chaque requête individuelle, puis définissez comment votre application doit suspendre ou reprendre le traitement.

Référence suivante

Gérez les erreurs de l’API

Codes d’erreurMettre en place une gestion prévisible des erreurs →TarifsComparer les packs de crédits →