Referência da APIGET

Uso de alterações de palavras-chave

Verifica a cota mensal de edição de palavras-chave e o uso atual.

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

Verifica a cota mensal de edição de palavras-chave e o uso atual.

Token Bearer (token de API do RedReplier)

Autenticação

Envie um token de API do RedReplier como Bearer token em cada requisição. Os tokens começam com redreplier_; o RedReplier resolve a conta a partir do token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parâmetros

Este endpoint não aceita parâmetros de caminho nem de consulta.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna o uso atual de edição de palavras-chave.

  • limit (number): Cota mensal de edição de palavras-chave; -1 significa ilimitado.
  • used (number): Edições de palavras-chave usadas neste mês.
  • remaining (number): Edições restantes neste mês; -1 significa ilimitado.
  • unlimited (boolean): Indica se a cota é ilimitada.

Exemplo de requisição

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

Notas

Somente edições de palavras-chave contam contra essa cota. Adicionar e desativar palavras-chave não contam.

Erros

  • 400 Bad Request: Entrada, URL, UUID, enum, parâmetro de consulta ou corpo inválido.
  • 401 Unauthorized: Bearer token ausente ou inválido.
  • 404 Not Found: O recurso não existe para a conta do token.
  • 500 Internal Server Error: Erro inesperado do servidor.
Exemplo de solicitação (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/change-usage \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "limit": 10,
  "used": 3,
  "remaining": 7,
  "unlimited": false
}