API status codes

API status codes geven aan of een request succesvol is verlopen of dat er iets misging.

2xx – Succes

Alle codes die beginnen met een 2 (bijvoorbeeld 200 of 201) betekenen dat het verzoek succesvol is uitgevoerd.

Let op: in sommige systemen, zoals Klaviyo, kan alles wat geen 200 is (bijvoorbeeld 201) alsnog als een foutmelding in rood worden weergegeven. Dit hoeft overigens niet te betekenen dat er een fout is.

4xx – Fout aan gebruikerskant

Codes die beginnen met een 4 wijzen op een probleem aan jouw kant. Bijvoorbeeld:

  • Een verkeerd template ID in je JSON

  • Een fout in het design

  • Vergeten van een merge variable

  • Een ontbrekende komma of syntaxfout in de JSON

De exacte reden van de foutmelding staat altijd in de response van de API.

Voorbeelden:

400 – Bad Request: Controleer of alle velden correcte data bevatten en of de JSON-syntax klopt. Vaak gaat het om een klein foutje, zoals een vergeten merge variable.

401 – Unauthorized: Dit betekent een authenticatieprobleem. Controleer of je API key correct is.

5xx – Probleem aan de kant van Print.one

Deze codes wijzen op een probleem bij Print.one. In de meeste gevallen is dit maar tijdelijk. Wacht even, probeer het opnieuw en neem contact op met ons als het probleem aanhoudt.

Alle foutmeldingen worden automatisch naar ons systeem gestuurd, zodat ons team direct op de hoogte is en je eventueel kan helpen.