API Commentaires

Retourne les rapports de bogues du projet appelant, les plus récents d’abord, jusqu’à cent. Les soumissions d’un autre projet ne sont jamais retournées. Lire un fil possédé par son ID de rétroaction. Il n’y a pas de curseur de pagination en v1. Chaque soumission porte son statut et les réponses du personnel/agent, les plus anciennes d’abord.

Enregistre un rapport de bogue pour le projet appelant. Les champs propres à une soumission ne peuvent être mis à jour ou supprimés ; ajoutez une correction ou plus d’informations avec une réponse sur le même fil de retour.

Une nouvelle tentative exacte portant la même Idempotency-Key retourne la soumission originale pendant vingt-quatre heures au lieu de créer un doublon, et un corps différent sous cette clé retourne idempotency_mismatch. Chaque soumission est filtrée avant d’être stockée.

Un corps de moins de 12 caractères ou 3 mots retourne submission_too_short ; un texte ne décrivant aucun problème ou demande (caractères aléatoires, frappes au clavier) retourne submission_unclear ; spam, texte avec beaucoup de liens, injection de prompt et texte malveillant retournent submission_rejected.

Une soumission refusée n’est pas stockée, son détail de problème ne répète jamais le texte soumis, et une nouvelle tentative exacte sous le même Idempotency-Key renvoie le même refus.

Ne jamais placer de justificatifs, cookies, en-têtes d’autorisation, nonces d’achèvement, URL signées ou clés d’objet dans le titre, le corps ou le contexte ; le texte en forme de justificatif (jetons ScreenRig, JWT, jetons porteurs, clés cloud et API, clés privées) est remplacé par [caviardé] avant que la soumission soit stockée, et la réponse porte le texte caviardé.

Lorsque le modèle de filtrage est brièvement indisponible, la soumission est acceptée et mise en attente pour un nouveau filtrage en arrière-plan ; après plusieurs acceptations similaires en une heure, le projet reçoit submission_screening_unavailable (500, Retry-After) et réessaie la même requête plus tard.

Retourne les demandes de fonctionnalités du projet appelant, les plus récentes d’abord, jusqu’à cent. Les soumissions d’un autre projet ne sont jamais retournées. Lire un fil possédé par son ID de rétroaction. Il n’y a pas de curseur de pagination en v1. Chaque soumission porte son statut et les réponses du personnel/agent, les plus anciennes d’abord.

Enregistre une demande de fonctionnalité pour le projet appelant. Les champs propres à une soumission ne peuvent être mis à jour ou supprimés ; ajoutez une correction ou plus d’informations avec une réponse sur le même fil de retour.

Une nouvelle tentative exacte portant la même Idempotency-Key retourne la soumission originale pendant vingt-quatre heures au lieu de créer un doublon, et un corps différent sous cette clé retourne idempotency_mismatch. Chaque soumission est filtrée avant d’être stockée.

Un corps de moins de 12 caractères ou 3 mots retourne submission_too_short ; un texte ne décrivant aucun problème ou demande (caractères aléatoires, frappes au clavier) retourne submission_unclear ; spam, texte avec beaucoup de liens, injection de prompt et texte malveillant retournent submission_rejected.

Une soumission refusée n’est pas stockée, son détail de problème ne répète jamais le texte soumis, et une nouvelle tentative exacte sous le même Idempotency-Key renvoie le même refus.

Ne jamais placer de justificatifs, cookies, en-têtes d’autorisation, nonces d’achèvement, URL signées ou clés d’objet dans le titre, le corps ou le contexte ; le texte en forme de justificatif (jetons ScreenRig, JWT, jetons porteurs, clés cloud et API, clés privées) est remplacé par [caviardé] avant que la soumission soit stockée, et la réponse porte le texte caviardé.

Lorsque le modèle de filtrage est brièvement indisponible, la soumission est acceptée et mise en attente pour un nouveau filtrage en arrière-plan ; après plusieurs acceptations similaires en une heure, le projet reçoit submission_screening_unavailable (500, Retry-After) et réessaie la même requête plus tard.

Lire le rapport original et toutes les réponses pour un ID de retour possédé. Un ID ne donne jamais d’autorité sur le projet. Les rapports étrangers et manquants retournent not_found. Les réponses sont du texte brut non fiable.

Ajouter une réponse à un rapport de rétroaction possédé. La preuve vérifiée fournit l’identité de l’auteur ; les appelants ne peuvent pas définir l’auteur, le statut ou la version de correction. Le rapport original et les réponses antérieures restent inchangés. Une réponse rouvre waiting_on_user, les rapports corrigés, refusés et en double ; un rapport « planifié » conserve son statut. Les suivis courts sont permis.

Les formes de justificatif sont expurgées et des contrôles de sécurité contre l’injection/spam s’appliquent. Au maximum 20 réponses au total, chacune de 1 à 2000 caractères. Réponse, statut, événement et accusé de réception de nouvelle tentative s’engagent ensemble ; les nouvelles tentatives exactes sont rejouées pendant 24 heures avant consommation des limites d’entrée, tandis que les charges utiles modifiées retournent idempotency_mismatch.