API-referentieGET

Activering van wachtende trefwoorden vooraf bekijken

Bekijk vooraf wat een upgrade van je abonnement kost om elk wachtend trefwoord te dekken. Alleen-lezen: er wordt niets afgeschreven of geactiveerd.

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

Bekijk vooraf wat een upgrade van je abonnement kost om elk wachtend trefwoord te dekken. Alleen-lezen: er wordt niets afgeschreven of geactiveerd.

Bearer-token (RedReplier API-token)

Authenticatie

Stuur bij elk verzoek een RedReplier API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier haalt het account uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaard te werken; zie Workspaces weergeven.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameters

Dit endpoint heeft geen pad- of queryparameters.

Request body

Dit endpoint heeft geen JSON-body nodig.

Respons

Geeft een voorbeeld van de trefwoordfacturering terug.

  • currentPlanName (string | null): Naam van het huidige abonnement, of null als er geen actief is.
  • currentMonthlyPrice (number): Huidige maandprijs.
  • targetPlanName (string | null): Abonnement dat nodig is voor het gevraagde aantal trefwoorden, of null als er niets hoeft te veranderen.
  • targetMonthlyPrice (number): Maandprijs na de wijziging.
  • immediateCharge (number): Naar rato berekend bedrag dat direct wordt afgeschreven voor de huidige factuurperiode.
  • targetKeywords (number): Beoogd aantal actieve trefwoorden.
  • isUpgrade, isDowngrade, requiresImmediatePayment (boolean): Vlaggen voor de factureringswijziging.

Voorbeeldverzoek

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

Opmerkingen

Alleen-lezen. De API kan het abonnement niet upgraden: voer de wijziging door in de RedReplier-app en roep daarna Wachtende trefwoorden activeren of GET /websites aan om te activeren wat nu past.

Fouten

  • 400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.
  • 401 Unauthorized: Bearer-token ontbreekt of is ongeldig, of code: "token_issuer_lost_access" als de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.
  • 403 Forbidden: code: "subscription_required" als het abonnement van de workspace geen API-toegang bevat, code: "workspace_access_denied" als X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" als je rol in de workspace geen redreplier.write heeft (Admin en Editor hebben die wel).
  • 404 Not Found: De resource bestaat niet voor het account van het token.
  • 429 Too Many Requests: Rate limit overschreden. Wacht het aantal seconden uit Retry-After.
  • 500 Internal Server Error: Onverwachte serverfout.
Voorbeeldverzoek (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/activate-pending/preview \
  --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
}