API-ReferenzGET

Keyword-Edit-Nutzung

Prüft das monatliche Keyword-Edit-Kontingent und die aktuelle Nutzung.

GEThttps://ai.redreplier.com/ai-app/api/v1/keywords/change-usage

Prüft das monatliche Keyword-Edit-Kontingent und die aktuelle Nutzung.

Bearer-Token (RedReplier-API-Token)

Authentifizierung

Sende bei jeder Anfrage ein RedReplier-API-Token als Bearer-Token. Tokens beginnen mit redreplier_; RedReplier ermittelt das Konto aus dem Token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameter

Dieser Endpoint hat keine Pfad- oder Query-Parameter.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt die aktuelle Keyword-Edit-Nutzung zurück.

  • limit (number): Monatliches Keyword-Edit-Kontingent; -1 bedeutet unbegrenzt.
  • used (number): In diesem Monat genutzte Keyword-Edits.
  • remaining (number): Verbleibende Keyword-Edits in diesem Monat; -1 bedeutet unbegrenzt.
  • unlimited (boolean): Gibt an, ob das Kontingent unbegrenzt ist.

Beispielanfrage

curl -s https://ai.redreplier.com/ai-app/api/v1/keywords/change-usage \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Hinweise

Nur Keyword-Bearbeitungen zählen gegen dieses Kontingent. Hinzufügen und Deaktivieren zählen nicht.

Fehler

  • 400 Bad Request: Ungültige Eingabe, URL, UUID, Enum, Query-Parameter oder Body.
  • 401 Unauthorized: Fehlendes oder ungültiges Bearer-Token.
  • 404 Not Found: Die Ressource existiert nicht für das Token-Konto.
  • 500 Internal Server Error: Unerwarteter Serverfehler.
Beispielanfrage (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/change-usage \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "limit": 10,
  "used": 3,
  "remaining": 7,
  "unlimited": false
}