PIM · Referentie
Foutmeldingen
De foutmeldingen van de API, wat ze betekenen en wat je eraan doet.
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.
{
"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
| 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.
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.
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 doet dat automatisch, tot drie keer. Blijft het mis gaan, meld het dan bij de PIM-beheerder, met het tijdstip en de statuscode.
Vraag zuinig
Probeer bij een fout niet in een snelle lus opnieuw. Wacht tussen pogingen, bijvoorbeeld een paar seconden meer bij elke poging.