Referência da APIDEL

Excluir palavra-chave

Exclui permanentemente uma palavra-chave pendente de um site monitorado antes de ela ser ativada ou cobrada.

DELETEhttps://ai.redreplier.com/ai-app/api/v1/keywords/{keywordId}

Exclui permanentemente uma palavra-chave pendente de um site monitorado antes de ela ser ativada ou cobrada.

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

  • keywordId (caminho, UUID, obrigatório): Palavra-chave pendente a ser excluída.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna uma confirmação de exclusão.

  • deleted (boolean): Sempre true quando a exclusão é concluída com sucesso.

Exemplo de requisição

curl -X DELETE https://ai.redreplier.com/ai-app/api/v1/keywords/22222222-2222-4222-8222-222222222222 \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Notas

Apenas palavras-chave PENDING podem ser excluídas. Desative palavras-chave ativas em vez disso.

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 DELETE \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/73a3c9b6-3e5f-4a53-a2c6-70c5ef7f2f6d \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "deleted": true
}