Référence de l'APIGET

Prévisualiser la facturation des mots-clés

Prévisualise l’abonnement et le prix pour un nombre souhaité de mots-clés actifs.

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

Prévisualise l’abonnement et le prix pour un nombre souhaité de mots-clés actifs.

Jeton Bearer (jeton API RedReplier)

Authentification

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

  • desiredKeywordCount (requête, entier, requis, min 0): Nombre total souhaité de mots-clés actifs.

Corps de la requête

Cet endpoint ne nécessite aucun corps JSON.

Réponse

Renvoie un aperçu de facturation des mots-clés.

  • currentPlanName (string | null): Nom de l’abonnement actuel, ou null s’il n’y en a pas.
  • currentMonthlyPrice (number): Prix mensuel actuel.
  • targetPlanName (string | null): Abonnement nécessaire pour le nombre de mots-clés demandé, ou null si aucun changement n’est nécessaire.
  • targetMonthlyPrice (number): Prix mensuel après le changement.
  • immediateCharge (number): Montant immédiat proratisé pour la période de facturation en cours.
  • targetKeywords (number): Nombre cible de mots-clés actifs.
  • isUpgrade, isDowngrade, requiresImmediatePayment (boolean): Indicateurs du changement de facturation.

Exemple de requête

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

Notes

Cet endpoint ne modifie pas l’abonnement.

Erreurs

  • 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
  • 401 Unauthorized: Bearer token manquant ou non valide.
  • 404 Not Found: La ressource n’existe pas pour le compte du token.
  • 500 Internal Server Error: Erreur serveur inattendue.
Exemple de requête (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
}