Previsualizar facturación de palabras clave

Autenticación

Envía un token de API de RedReplier como Bearer token en cada solicitud. Los tokens empiezan por redreplier_; RedReplier resuelve la cuenta desde el token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parámetros

• desiredKeywordCount (consulta, entero, obligatorio, mínimo 0): Cantidad total deseada de palabras clave activas.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve una vista previa de facturación de palabras clave.

• currentPlanName (string | null): Nombre del plan actual, o null si no hay uno activo.
• currentMonthlyPrice (number): Precio mensual actual.
• targetPlanName (string | null): Plan necesario para la cantidad de palabras clave solicitada, o null si no se requiere cambio.
• targetMonthlyPrice (number): Precio mensual después del cambio.
• immediateCharge (number): Cargo inmediato prorrateado para el periodo de facturación actual.
• targetKeywords (number): Cantidad objetivo de palabras clave activas.
• isUpgrade, isDowngrade, requiresImmediatePayment (boolean): Indicadores del cambio de facturación.

Solicitud de ejemplo

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

Notas

Este endpoint no cambia la suscripción.

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido.
• 404 Not Found: El recurso no existe para la cuenta del token.
• 500 Internal Server Error: Error inesperado del servidor.