# Foutmeldingen

De foutmeldingen van de API, wat ze betekenen en wat je eraan doet.

Sectie: PIM · Referentie
Canonieke URL: https://docs.omniretailconnect.nl/pim/referentie/foutmeldingen

## De vorm van een fout

Een fout heeft een HTTP-status en een JSON-antwoord met één veld, `message`. Stuur altijd de header `Accept: application/json` mee, dan krijg je ook bij fouten JSON.

**Foutantwoord**

```json
{
  "message": "Invalid token"
}
```

Controleer in je code eerst de HTTP-status. Alleen `200` geeft producten. De tekst in `message` is Engels en kan veranderen. Baseer je logica daarom op de status, en laat de tekst alleen zien aan een mens.

## Meldingen en wat je eraan doet

*Foutmeldingen van de PIM API*

| Status | Melding | Wat het is en wat je doet |
| --- | --- | --- |
| `401` | `No token provided` | Het verzoek bevat geen token. Stuur de header `Authorization: Bearer <token>` mee. |
| `401` | `Invalid token` | Het token klopt niet. Controleer op typefouten, een spatie of regeleinde aan het eind en of je het hele token gebruikt. Stuur alleen het token na `Bearer`, zonder iets ervoor. Klopt alles, vraag de PIM-beheerder dan om je token te controleren. |
| `401` | `Ip Address is not allowed to connect` | Voor jouw bedrijf zijn vaste IP-adressen ingesteld en je verzoek komt van een ander adres. Vraag de PIM-beheerder om het uitgaande IP-adres van je server te activeren. |
| `400` | `Requested filter(s) ... are not allowed.` | Je gebruikt een filternaam die niet bestaat. De melding noemt de toegestane filters. Controleer de spelling. |
| `422` | `Invalid updated_at filter value.` | Het tijdstip in `filter[updated_at]` is niet te lezen. Gebruik bijvoorbeeld `2026-03-12T10:00:00` en laat de tijdzone weg. |
| `422` | `Invalid stock filter value.` | De waarde van `filter[stock]` is geen getal. Dit gebeurt alleen bij `GET /products`. Gebruik een getal, eventueel met een voorvoegsel, zoals `%3E%3D5`. |

Meer over het IP-slot staat bij [Verbinden](https://docs.omniretailconnect.nl/pim/aan-de-slag/verbinden.md#ip-adressen).

Bij `GET /my-products` geeft een stockfilter met een waarde die geen getal is geen fout. Je krijgt dan een lege lijst. Zie [Mijn producten](https://docs.omniretailconnect.nl/pim/api/mijn-producten.md#filter-stock).

## Geen antwoord of een serverfout

Krijg je geen antwoord, of een status vanaf `500`, dan ligt het meestal niet aan je verzoek. Wacht even en probeer het opnieuw. Het script bij [Synchroniseren](https://docs.omniretailconnect.nl/pim/api/synchroniseren.md#script) doet dat automatisch, tot drie keer. Blijft het mis gaan, meld het dan bij de PIM-beheerder, met het tijdstip en de statuscode.

> **Opmerking — Vraag zuinig:** Probeer bij een fout niet in een snelle lus opnieuw. Wacht tussen pogingen, bijvoorbeeld een paar seconden meer bij elke poging.