Feedbacks - Olostep Docs

Über den Olostep /v1/feedbacks Endpunkt kannst du melden, wenn die API etwas falsch gemacht hat. Rufe ihn von einem Agenten oder deinem eigenen Code auf, wenn ein Ergebnis falsch, unvollständig, langsam, fehlgeschlagen oder nicht mit der Dokumentation übereinstimmend war.

Sende die id des Objekts, auf das sich das Feedback bezieht, damit wir es genau zur Anfrage zurückverfolgen können
Markiere den Bericht mit einer Kategorie und optionalen Symptomcodes
Das Einreichen von Feedback ist kostenlos und funktioniert auch, wenn die Credits deines Teams erschöpft sind

Für API-Details siehe die Submit Feedback API Reference.

Feedback einreichen

category und note sind erforderlich. Füge related_object_id hinzu, wenn du sie hast: eine scrape_…, batch_… oder ähnliche Ressourcen-ID, oder die error_… ID, wenn der Aufruf fehlgeschlagen ist.

import requests
import json

API_KEY = "<YOUR_API_KEY>"

payload = {
    "category": "output_quality",
    "issues": ["missing_content", "broken_formatting"],
    "note": "Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.",
    "affected_endpoint": "POST /v1/scrapes",
    "related_object_id": "scrape_abc1234567",
    "url": "https://example.com/pricing"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.olostep.com/v1/feedbacks",
    headers=headers,
    json=payload
)
print(json.dumps(response.json(), indent=2))

const res = await fetch('https://api.olostep.com/v1/feedbacks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <YOUR_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    category: 'output_quality',
    issues: ['missing_content', 'broken_formatting'],
    note: 'Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.',
    affected_endpoint: 'POST /v1/scrapes',
    related_object_id: 'scrape_abc1234567',
    url: 'https://example.com/pricing'
  })
})
console.log(await res.json())

curl -X POST https://api.olostep.com/v1/feedbacks \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "output_quality",
    "issues": ["missing_content", "broken_formatting"],
    "note": "Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.",
    "affected_endpoint": "POST /v1/scrapes",
    "related_object_id": "scrape_abc1234567",
    "url": "https://example.com/pricing"
  }'

Antwort

Die Antwort ist das gespeicherte feedback Objekt. Es gibt keinen Listen- oder Abruf-Endpunkt; Feedback wird auf unserer Seite gelesen.

{
  "object": "feedback",
  "id": "feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e",
  "category": "output_quality",
  "issues": ["missing_content", "broken_formatting"],
  "note": "Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.",
  "affected_endpoint": "POST /v1/scrapes",
  "related_object_id": "scrape_abc1234567",
  "url": "https://example.com/pricing",
  "created_at": "2026-10-23T00:00:00.000Z"
}

Felder

Feld	Erforderlich	Hinweise
`category`	ja	Eine von `output_quality`, `reliability`, `performance`, `documentation`, `api_usability`, `feature_gap`, `other`
`note`	ja	Was schiefgelaufen ist und was du stattdessen erwartet hast, bis zu 4.000 Zeichen
`issues`	nein	Bis zu 20 `snake_case` Symptomcodes. Dokumentierte Codes sind unten aufgeführt; jeder andere Code in derselben Form wird akzeptiert
`affected_endpoint`	nein	`METHOD /path` mit dem kanonischen Pluralpfad, zum Beispiel `POST /v1/scrapes`
`related_object_id`	nein	Die `id` des Scrapes, Batches, Crawls, der Antwort oder eines anderen Objekts, oder die `error_…` ID, wenn der Aufruf fehlgeschlagen ist
`url`	nein	Die Seite, auf die sich das Feedback bezieht, wie die URL, die gescraped wurde

Symptomcodes

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.