Poser un retour utilisateur sur une réponse tracée
Attache un pouce levé/baissé à une réponse déjà servie, via le trace_id qu’elle portait.
Idempotent : re-poster écrase le vote précédent. C’est ce qui permet à l’utilisateur de changer d’avis, et à un client de re-tenter un envoi perdu sans compter deux fois.
404 quand le trace_id est inconnu — typiquement une réponse servie alors que la journalisation était coupée, ou plus vieille que la rétention. 503 quand la journalisation est désactivée sur cette instance : il n’y a alors aucune trace à noter, et le dire est plus utile que d’accepter un vote qui n’ira nulle part.
Authorizations
Locus API key — paste the raw lsk_… value (no 'Bearer ' prefix).
Body
L'identifiant rendu par /v2/retrieve (champ trace_id de la payload, ou de la ligne done du flux).
1 pouce levé · -1 pouce baissé · 0 vote retiré.
0 existe pour que se dédire soit un geste écrit comme un autre : sans lui, retirer un pouce obligerait à supprimer la ligne, et on perdrait la réponse tracée en même temps que l'avis.
-1 <= x <= 1Motif libre, facultatif — surtout utile après un pouce baissé.
2000