> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Feedbacks

> Rapporteer een verkeerd, onvolledig of mislukt API-resultaat. Kost geen credits.

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](https://docs.olostep.com/api-reference/feedbacks/create.md).

## 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.

```python Python theme={null}
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))
```

```js Node theme={null}
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())
```

```bash cURL theme={null}
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.

```json theme={null}
{
  "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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.