Nutzung & Kontingent

Die GenderAPI-Plattform ermöglicht es dir, jederzeit deinen aktuellen Guthabenstand über ein spezielles Endpoint abzufragen. Dies hilft dir, deinen Verbrauch zu überwachen und unerwartete Unterbrechungen bei umfangreichen Operationen zu vermeiden.

✅ Überprüfe dein verbleibendes Guthaben

Du kannst Informationen zu deinem aktuellen Kontingent über folgendes Endpoint abrufen:

GET https://api.genderapi.io/api/remaining?key=YOUR_API_KEY

Beispielanfrage mit curl:

curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"

✅ Beispielantwort

Die API gibt ein JSON-Objekt zurück:

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

Antwortfelder

Feld	Typ	Beschreibung
status	Boolean	Zeigt an, ob die Anfrage erfolgreich war. Gibt `true` zurück, wenn dein API-Key gültig ist.
remaining	Integer	Anzahl der verbleibenden API-Credits in deinem Konto.
expiresAt	Integer (Timestamp)	Unix-Timestamp, der angibt, wann dein aktuelles Kreditpaket abläuft.

Anwendungsfälle

Anzeige der aktuellen Kontingentinformationen im Dashboard-UI.
Auslösen von Warnmeldungen, wenn dein Guthaben unter einen bestimmten Schwellenwert fällt.
Integration mit Abrechnungs- oder Überwachungstools, um Unterbrechungen des Dienstes zu vermeiden.

Wichtig: Überwache stets dein verbleibendes Guthaben, um unerwartete Fehler aufgrund aufgebrauchter Kontingente zu vermeiden. Hochvolumige oder automatisierte Skripte sollten regelmäßig deinen Kontingentstatus prüfen.