Vai al contenuto principale
POST
Invia feedback
Usa questo endpoint quando un risultato è stato errato, incompleto, lento, fallito o non corrispondeva alla documentazione. È pensato per essere chiamato sia da agenti che da persone: quando la tua pipeline rileva un risultato errato, segnalalo con l’id dell’oggetto da cui proviene e possiamo risalire alla richiesta esatta. L’invio di feedback è gratuito e funziona anche quando i crediti del tuo team sono esauriti.

Cosa inviare

Esempio

cURL
La risposta è l’oggetto feedback memorizzato con il suo id e created_at. Non esiste ancora un endpoint per elencare o ottenere; il feedback viene letto dalla nostra parte.

Autorizzazioni

Authorization
string
header
obbligatorio

Header di autenticazione Bearer nella forma Bearer , dove è il tuo token di autenticazione.

Corpo

application/json
category
enum<string>
obbligatorio

Il motivo principale del feedback.

Opzioni disponibili:
output_quality,
reliability,
performance,
documentation,
api_usability,
feature_gap,
other
note
string
obbligatorio

Cosa è andato storto e cosa ti aspettavi invece.

Required string length: 1 - 4000
Esempio:

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

issues
string[]

Sintomi specifici, come codici in snake_case minuscolo. Codici documentati: 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. Qualsiasi altro codice della stessa forma è accettato.

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

L'endpoint a cui si riferisce il feedback, come METHOD /path con il percorso plurale canonico.

Required string length: 1 - 200
Esempio:

"POST /v1/scrapes"

L'id dell'oggetto restituito dall'API a cui si riferisce il feedback: un id di risorsa come scrape_…, batch_… o simile, o l'id dell'oggetto errore (error_…) quando la chiamata è fallita.

Required string length: 1 - 128
Esempio:

"scrape_abc1234567"

url
string<uri>

La pagina a cui si riferisce il feedback, come l'URL che è stato scrappato.

Maximum string length: 2048
Esempio:

"https://example.com/pricing"

Risposta

Il feedback memorizzato.

object
enum<string>
obbligatorio
Opzioni disponibili:
feedback
id
string
obbligatorio
Esempio:

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

category
string
obbligatorio
issues
string[]
obbligatorio
note
string
obbligatorio
created_at
string<date-time>
obbligatorio
Esempio:

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

affected_endpoint
string
url
string