Trefwoordfacturering vooraf bekijken
Bekijk vooraf het abonnement en de maandprijs voor het gewenste aantal actieve trefwoorden. Alleen-lezen: de API wijzigt nooit het abonnement en brengt nooit iets in rekening.
https://ai.redreplier.com/ai-app/api/v1/keywords/billing-previewBekijk vooraf het abonnement en de maandprijs voor het gewenste aantal actieve trefwoorden. Alleen-lezen: de API wijzigt nooit het abonnement en brengt nooit iets in rekening.
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/jsonParameters
desiredKeywordCount(query, integer, verplicht, min. 0): Gewenst totaal aantal actieve trefwoorden.
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, ofnullals er geen actief is.currentMonthlyPrice(number): Huidige maandprijs.targetPlanName(string | null): Abonnement dat nodig is voor het gevraagde aantal trefwoorden, ofnullals 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/billing-preview?desiredKeywordCount=12' \
-H 'Authorization: Bearer redreplier_test_1234567890'Opmerkingen
Alleen-lezen: de API wijzigt nooit het abonnement. Abonnementswijzigingen doe je in de RedReplier-app.
Fouten
400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.401 Unauthorized: Bearer-token ontbreekt of is ongeldig, ofcode: "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"alsX-Workspace-Ideen workspace noemt waar deze inloggegevens geen toegang toe hebben, ofcode: "permission_denied"als je rol in de workspace geenredreplier.writeheeft (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 uitRetry-After.500 Internal Server Error: Onverwachte serverfout.
curl --request GET \
--url https://ai.redreplier.com/ai-app/api/v1/keywords/billing-preview?desiredKeywordCount=25 \
--header 'Authorization: Bearer redreplier_test_1234567890'{
"currentPlanName": "Starter",
"currentMonthlyPrice": 49,
"targetPlanName": "Growth",
"targetMonthlyPrice": 99,
"immediateCharge": 18.42,
"targetKeywords": 25,
"isUpgrade": true,
"isDowngrade": false,
"requiresImmediatePayment": true
}