Expliquer une mention

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, tags et aiReplySuggestion, 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, HACKERNEWS, FACEBOOK ou FACEBOOK_GROUP.
• 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 contient le subreddit pour les sources Reddit et l'id du groupe pour FACEBOOK_GROUP, et vaut null pour les autres sources.
• 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.
• aiReplySuggestion (string | null): Réponse rédigée par IA, à relire avant publication, 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.

Notes

Si l’explication n’existe pas encore, RedReplier la génère à la demande. Le site web doit avoir une description; sans elle, la mention revient inchangée.

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, ou code: "token_issuer_lost_access" quand la personne qui a créé la clé API a été désactivée ou a quitté l'espace de travail.
• 403 Forbidden: code: "subscription_required" quand l'abonnement de l'espace de travail n'inclut pas l'accès à l'API, code: "workspace_access_denied" quand X-Workspace-Id désigne un espace de travail que ces identifiants ne peuvent pas atteindre, ou code: "permission_denied" quand votre rôle dans l'espace de travail n'a pas la permission redreplier.write (Admin et Editor l'ont).
• 404 Not Found: La ressource n’existe pas pour le compte du token.
• 429 Too Many Requests: Limite de débit dépassée. Attendez le nombre de secondes indiqué dans Retry-After.
• 500 Internal Server Error: Erreur serveur inattendue.