API-ReferenzGET

Keyword-Abrechnung vorab prüfen

Prüft Tarif und Preis für eine gewünschte Anzahl aktiver Keywords vorab.

GEThttps://ai.redreplier.com/ai-app/api/v1/keywords/billing-preview

Prüft Tarif und Preis für eine gewünschte Anzahl aktiver Keywords vorab.

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

  • desiredKeywordCount (Query, Integer, erforderlich, min. 0): Gewünschte Gesamtzahl aktiver Keywords.

Request-Body

Dieser Endpoint benötigt keinen JSON-Body.

Antwort

Gibt eine Keyword-Abrechnungsvorschau zurück.

  • currentPlanName (string | null): Aktueller Tarifname oder null, wenn keiner aktiv ist.
  • currentMonthlyPrice (number): Aktueller monatlicher Preis.
  • targetPlanName (string | null): Tarif für die angeforderte Keyword-Anzahl oder null, wenn keine Änderung nötig ist.
  • targetMonthlyPrice (number): Monatlicher Preis nach der Änderung.
  • immediateCharge (number): Anteilig sofort fälliger Betrag für die aktuelle Abrechnungsperiode.
  • targetKeywords (number): Zielanzahl aktiver Keywords.
  • isUpgrade, isDowngrade, requiresImmediatePayment (boolean): Flags für die Abrechnungsänderung.

Beispielanfrage

curl -s 'https://ai.redreplier.com/ai-app/api/v1/keywords/billing-preview?desiredKeywordCount=12' \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Hinweise

Dieser Endpoint ändert das Abonnement 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/billing-preview?desiredKeywordCount=25 \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "currentPlanName": "Starter",
  "currentMonthlyPrice": 49,
  "targetPlanName": "Growth",
  "targetMonthlyPrice": 99,
  "immediateCharge": 18.42,
  "targetKeywords": 25,
  "isUpgrade": true,
  "isDowngrade": false,
  "requiresImmediatePayment": true
}