Explicar menção

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

• mentionId (caminho, UUID, obrigatório): Menção a ser explicada.

Corpo da requisição

Este endpoint não exige um corpo JSON.

Resposta

Retorna um objeto Mention público com relevanceReason e tags, ou null se a menção não estiver disponível.

• id (string): UUID da menção.
• websiteId (string | null): UUID do site.
• source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY ou HACKERNEWS.
• keyword (string | null): Valor de palavra-chave que correspondeu.
• title, contentText, url, author, subreddit (string | null): Contexto de título, conteúdo e link. subreddit é preenchido apenas para fontes do Reddit e é null para X, Bluesky e Hacker News.
• status (string): NEW, APPROVED ou REJECTED.
• relevanceScore (number | null): Pontuação de relevância de IA de 0 a 100, ou null.
• relevanceReason (string | null): Explicação de IA para a correspondência, ou null.
• tags (string[]): Tags de relevância geradas por IA.
• publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Carimbos de publicação, ingestão, revisão, criação e atualização em formato ISO 8601, ou null.

Exemplo de requisição

curl -X POST https://ai.redreplier.com/ai-app/api/v1/mentions/33333333-3333-4333-8333-333333333333/explain \
  -H 'Authorization: Bearer redreplier_test_1234567890'

Notas

Se a explicação ainda não existir, o RedReplier a gera sob demanda.

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.