Feedbacks - Olostep Docs

Via het Olostep /v1/feedbacks eindpunt kun je rapporteren wanneer de API iets verkeerd heeft gedaan. Roep het aan vanuit een agent of vanuit je eigen code wanneer een resultaat verkeerd, onvolledig, traag, mislukt was of niet overeenkwam met de documentatie.

Stuur de id van het object waar de feedback over gaat zodat we het kunnen herleiden naar het exacte verzoek
Label het rapport met een categorie en optionele symptoomcodes
Het indienen van feedback is gratis, en het werkt zelfs wanneer de credits van je team op zijn

Voor API-details zie de Submit Feedback API Reference.

Feedback indienen

category en note zijn verplicht. Voeg related_object_id toe wanneer je deze hebt: een scrape_…, batch_…, of vergelijkbare resource id, of de error_… id wanneer de oproep mislukt is.

import requests
import json

API_KEY = "<YOUR_API_KEY>"

payload = {
    "category": "output_quality",
    "issues": ["missing_content", "broken_formatting"],
    "note": "De markdown laat de prijstabelvergelijking weg; verwachtte alle 4 rijen.",
    "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: 'De markdown laat de prijstabelvergelijking weg; verwachtte alle 4 rijen.',
    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": "De markdown laat de prijstabelvergelijking weg; verwachtte alle 4 rijen.",
    "affected_endpoint": "POST /v1/scrapes",
    "related_object_id": "scrape_abc1234567",
    "url": "https://example.com/pricing"
  }'

Response

De response is het opgeslagen feedback object. Er is geen lijst- of ophaal-eindpunt; feedback wordt aan onze kant gelezen.

{
  "object": "feedback",
  "id": "feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e",
  "category": "output_quality",
  "issues": ["missing_content", "broken_formatting"],
  "note": "De markdown laat de prijstabelvergelijking weg; verwachtte alle 4 rijen.",
  "affected_endpoint": "POST /v1/scrapes",
  "related_object_id": "scrape_abc1234567",
  "url": "https://example.com/pricing",
  "created_at": "2026-10-23T00:00:00.000Z"
}

Velden

Veld	Vereist	Opmerkingen
`category`	ja	Een van `output_quality`, `reliability`, `performance`, `documentation`, `api_usability`, `feature_gap`, `other`
`note`	ja	Wat er misging en wat je in plaats daarvan verwachtte, tot 4.000 tekens
`issues`	nee	Tot 20 `snake_case` symptoomcodes. Gedocumenteerde codes staan hieronder vermeld; elke andere code van dezelfde vorm wordt geaccepteerd
`affected_endpoint`	nee	`METHOD /path` met het canonieke meervoudige pad, bijvoorbeeld `POST /v1/scrapes`
`related_object_id`	nee	De `id` van de scrape, batch, crawl, antwoord of ander object, of de `error_…` id wanneer de oproep mislukt is
`url`	nee	De pagina waar de feedback over gaat, zoals de URL die werd gescraped

Symptoomcodes

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.