Passer au contenu principal
POST
Soumettre un feedback
Utilisez cet endpoint lorsqu’un résultat est incorrect, incomplet, lent, échoué, ou ne correspond pas à la documentation. Il est destiné à être appelé autant par des agents que par des personnes : lorsque votre pipeline détecte un mauvais résultat, signalez-le avec l’id de l’objet d’où il provient et nous pourrons le retracer jusqu’à la requête exacte. Soumettre un retour d’information est gratuit, et cela fonctionne même lorsque les crédits de votre équipe sont épuisés.

Que faut-il envoyer

Exemple

cURL
La réponse est l’objet feedback stocké avec son id et created_at. Il n’y a pas encore d’endpoint pour lister ou obtenir ; le retour d’information est lu de notre côté.

Autorisations

Authorization
string
header
requis

En-tête d'authentification Bearer sous la forme Bearer , où est ton jeton d'authentification.

Corps

application/json
category
enum<string>
requis

La raison principale du feedback.

Options disponibles:
output_quality,
reliability,
performance,
documentation,
api_usability,
feature_gap,
other
note
string
requis

Ce qui s'est mal passé et ce que tu attendais à la place.

Required string length: 1 - 4000
Exemple:

"The markdown drops the pricing comparison table; expected all 4 rows."

issues
string[]

Symptômes spécifiques, sous forme de codes en snake_case minuscules. Codes documentés : missing_content, incorrect_content, incomplete_content, broken_formatting, irrelevant_results, duplicate_results, stale_content, request_failed, timeout, slow_response, inconsistent_result, docs_mismatch, broken_example, confusing_schema, confusing_error, unsupported_website, unsupported_format. Tout autre code de la même forme est accepté.

Maximum array length: 20
Pattern: ^[a-z0-9](?:[a-z0-9_]{0,78}[a-z0-9])?$
Exemple:
affected_endpoint
string

Le point de terminaison concerné par le feedback, sous la forme METHOD /path avec le chemin pluriel canonique.

Required string length: 1 - 200
Exemple:

"POST /v1/scrapes"

L'id de l'objet retourné par l'API auquel le feedback se réfère : un id de ressource scrape_…, batch_… ou similaire, ou l'id de l'objet d'erreur (error_…) lorsque l'appel a échoué.

Required string length: 1 - 128
Exemple:

"scrape_abc1234567"

url
string<uri>

La page concernée par le feedback, comme l'URL qui a été scrappée.

Maximum string length: 2048
Exemple:

"https://example.com/pricing"

Réponse

Le feedback enregistré.

object
enum<string>
requis
Options disponibles:
feedback
id
string
requis
Exemple:

"feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e"

category
string
requis
issues
string[]
requis
note
string
requis
created_at
string<date-time>
requis
Exemple:

"2026-10-23T00:00:00.000Z"

affected_endpoint
string
url
string