Expliquer une mention

Authentification

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

• mentionId (chemin, UUID, requis): Mention à expliquer.

Corps de la requête

Cet endpoint ne nécessite aucun corps JSON.

Réponse

Renvoie un objet Mention public avec relevanceReason et tags, ou null si la mention n’est pas disponible.

• id (string): UUID de la mention.
• websiteId (string | null): UUID du site web.
• source (string): REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY ou HACKERNEWS.
• keyword (string | null): Valeur de mot-clé qui a correspondu.
• title, contentText, url, author, subreddit (string | null): Contexte du titre, du contenu et du lien. subreddit n’est renseigné que pour les sources Reddit et vaut null pour X, Bluesky et Hacker News.
• status (string): NEW, APPROVED ou REJECTED.
• relevanceScore (number | null): Score de pertinence IA de 0 à 100, ou null.
• relevanceReason (string | null): Explication IA de la correspondance, ou null.
• tags (string[]): Tags de pertinence générés par IA.
• publishedAt, ingestedAt, reviewedAt, createdAt, updatedAt (ISO string | null): Horodatages de publication, d’ingestion, de revue, de création et de mise à jour au format ISO 8601, ou null.

Exemple de requête

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

Notes

Si l’explication n’existe pas encore, RedReplier la génère à la demande.

Erreurs

• 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
• 401 Unauthorized: Bearer token manquant ou non valide.
• 404 Not Found: La ressource n’existe pas pour le compte du token.
• 500 Internal Server Error: Erreur serveur inattendue.