{"id":8118,"date":"2026-10-07T11:58:55","date_gmt":"2026-10-07T09:58:55","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/article\/kontainer-api-integratie\/"},"modified":"2026-10-07T11:58:55","modified_gmt":"2026-10-07T09:58:55","slug":"kontainer-api-integratie","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/nl\/article\/kontainer-api-integratie\/","title":{"rendered":"Kontainer-API-integratie"},"content":{"rendered":"

\"Koptekst<\/picture><\/p>\n

Met de Kontainer-API integreert je je bestaande software eenvoudig in het Kontainer-platform. Via deze koppeling tussen softwaresystemen kunnen je toepassingen gegevens met Kontainer uitwisselen en kun je veel verschillende processen automatiseren.<\/p>\n

Hierna lopen we de basis van de API-inrichting door.<\/p>\n

De informatie in dit artikel is technisch en gericht op ontwikkelaars die verantwoordelijk zijn voor de API-inrichting. Heb je vragen? Laat het ons gerust weten.<\/p>\n

Bezoek de integratiepagina van Kontainer<\/strong><\/a> voor meer informatie over onze API, met onder meer toepassingen en voordelen.<\/p>\n

\n

API-code<\/h2>\n

Ga direct naar de code voor de API-integratie HIER<\/strong><\/a>.<\/p>\n

LET OP:<\/strong> je moet je eigen unieke Kontainer-URL gebruiken in plaats van die in het voorbeeld in bovenstaande links (“app.kontainer.com”).<\/em><\/p>\n<\/blockquote>\n

\n

Aan de slag<\/h2>\n

Om de Kontainer-API te gebruiken, heb je een account bij Kontainer nodig en een API-toegangstoken.<\/p>\n

Neem contact op met je lokale beheerder of Kontainer Support<\/a> voor meer informatie over hoe je toegang tot de Kontainer-API krijgt.<\/p>\n

Authenticatie<\/h3>\n

De Kontainer-API gebruikt OAuth<\/em> voor authenticatie. Zodra je een API-toegangstoken hebt gekregen, moet je dit token bij elk verzoek meesturen via de Authorization-header als “Bearer”-waarde.<\/p>\n

Alle verzoeken moeten je API-toegangstoken in de Authorization-header bevatten: Authorization: Bearer {{access-token}}<\/code><\/p>\n

Contentonderhandeling<\/h3>\n

Alle verzoeken moeten<\/strong> de volgende header bevatten: Accept: application\/vnd.api+json<\/code>.
Verzoeken die JSON-gegevens versturen moeten<\/strong> de volgende header bevatten: Content-Type: application\/vnd.api+json<\/code><\/p>\n

JSON:API-standaard<\/h3>\n

De Kontainer-API is een RESTful<\/em>-API die de JSON:API<\/a>-standaard volgt. Raadpleeg deze standaard voor meer informatie over hoe de verzoek- en antwoorddocumenten zijn opgebouwd.<\/p>\n

Resourcetypen<\/h2>\n

De API biedt de volgende resourcetypen: files, folders, users, tags, channels, elements, element-options, categories, custom-fields, download-templates, video-download-templates, cdn, user-groups, folder permissions, consent wards, consent agreements, consent parties, statistics en job logs.<\/p>\n

Schrijfbewerkingen<\/h2>\n

De API ondersteunt schrijfbewerkingen voor alle resources: POST<\/strong> om aan te maken, PATCH<\/strong> om bij te werken en DELETE<\/strong> om te verwijderen. De API is dus niet alleen-lezen.<\/p>\n

Limieten voor aanvragen<\/h3>\n

De standaardlimieten voor de API gelden voor alle endpoints die wij aanbieden, en de limiet is 500<\/code> verzoeken per minuut. Wordt de gedefinieerde limiet overschreden, dan antwoordt de API met de melding: 429: Too Many Attempts<\/code>.<\/p>\n

Antwoordcodes<\/h3>\n

De Kontainer-API antwoordt met HTTP-statuscodes en op JSON gebaseerde foutcodes en -meldingen.<\/p>\n

HTTP-statuscodes<\/h3>\n

De volgende tabel geeft een overzicht van de HTTP-statuscodes die worden geretourneerd.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP-statuscode<\/strong><\/th>\nTekst<\/strong><\/th>\nBeschrijving<\/strong><\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\nOK<\/td>\nGelukt.<\/td>\n<\/tr>\n
201<\/td>\nCreated<\/td>\nObject aangemaakt.<\/td>\n<\/tr>\n
204<\/td>\nNo Content<\/td>\nGeen inhoud geretourneerd.<\/td>\n<\/tr>\n
401<\/td>\nUnauthorized<\/td>\nToken ontbreekt of is ongeldig.<\/td>\n<\/tr>\n
403<\/td>\nForbidden<\/td>\nResource of verzoek wordt niet ondersteund<\/td>\n<\/tr>\n
404<\/td>\nNot Found<\/td>\nObject niet gevonden.<\/td>\n<\/tr>\n
406<\/td>\nNot Acceptable<\/td>\nVerzoek niet acceptabel<\/td>\n<\/tr>\n
409<\/td>\nConflict<\/td>\nConflict in de toestand van de toepassing of resource.<\/td>\n<\/tr>\n
422<\/td>\nValidation Error<\/td>\nEr is een validatiefout opgetreden.<\/td>\n<\/tr>\n
429<\/td>\nToo Many Requests<\/td>\nLimiet voor aanvragen overschreden.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Foutmeldingen<\/h3>\n

Het volgende voorbeeld laat zien hoe een foutmelding eruitziet bij HTTP-statuscode 401 - Unauthorized<\/code>.<\/p>\n

\"Voorbeeld<\/picture><\/p>\n

Filters<\/h2>\n

Op ondersteunde endpoints kun je filters toepassen om de geretourneerde resultaten te beperken. Filters past je toe met de queryparameter filter<\/code>. De ondersteunde filtervelden vindt je in het onderdeel Filter Attributes<\/strong> van elk endpoint.<\/p>\n

Voorbeelden:<\/strong><\/p>\n

Een lijst met categorie-items\/producten ophalen:<\/p>\n

filter[description][like]<\/code> : Shoes<\/code><\/p>\n

Items zoeken op exact EAN-nummer:<\/p>\n

filter[ean][eq]<\/code> : 4194382028137<\/code><\/p>\n

Items zoeken na een bepaalde datum:<\/p>\n

filter[released_on][gt]<\/code> : 2020-01-01<\/code><\/p>\n

Items zoeken met een eenheidsprijs groter dan of gelijk aan 22,50 en kleiner dan 50,00:<\/p>\n

filter[unit_cost][gte]<\/code> : 22.50<\/code><\/p>\n

filter[unit_cost][lt]<\/code> : 50.00<\/code><\/p>\n

Controleren of bestanden in een PIM-gegevensveld worden gebruikt:<\/p>\n

filter[asset][exists]<\/code> : 1<\/code><\/p>\n

filter[asset][exists]<\/code> : 0<\/code><\/p>\n

Filtervoorwaarden<\/strong><\/p>\n