Referencia de APIGET

Uso de cambios de palabras clave

Consulta el cupo mensual de edición de palabras clave y el uso actual.

GEThttps://ai.redreplier.com/ai-app/api/v1/keywords/change-usage

Consulta el cupo mensual de edición de palabras clave y el uso actual.

Token Bearer (token de API de RedReplier)

Parámetros

Este endpoint no acepta parámetros de ruta ni de consulta.

Cuerpo de la solicitud

Este endpoint no requiere un cuerpo JSON.

Respuesta

Devuelve el uso actual de edición de palabras clave.

  • limit (number): Cupo mensual de edición de palabras clave; -1 significa ilimitado.
  • used (number): Ediciones de palabras clave usadas este mes.
  • remaining (number): Ediciones restantes este mes; -1 significa ilimitado.
  • unlimited (boolean): Indica si el cupo es ilimitado.

Notas

Las ediciones de palabras clave son ilimitadas en todos los planes actuales, así que la respuesta es limit: -1, used: 0, remaining: -1 y unlimited: true. El endpoint se mantiene para clientes que presupuestan ediciones. Agregar, desactivar, activar y eliminar palabras clave nunca contó.

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, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
  • 403 Forbidden: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
  • 404 Not Found: El recurso no existe para la cuenta del token.
  • 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
  • 500 Internal Server Error: Error inesperado del servidor.
Solicitud de ejemplo (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/change-usage \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "limit": -1,
  "used": 0,
  "remaining": -1,
  "unlimited": true
}