{"id":8319,"date":"2026-10-08T07:56:22","date_gmt":"2026-10-08T05:56:22","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/article\/integration-de-lapi-kontainer\/"},"modified":"2026-10-08T07:56:22","modified_gmt":"2026-10-08T05:56:22","slug":"integration-de-lapi-kontainer","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/fr\/article\/integration-de-lapi-kontainer\/","title":{"rendered":"Int\u00e9gration de l’API Kontainer"},"content":{"rendered":"

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

L’API Kontainer facilite l’int\u00e9gration de vos logiciels existants \u00e0 la plateforme Kontainer. Cette interface logiciel \u00e0 logiciel permet \u00e0 vos applications d’\u00e9changer des donn\u00e9es avec Kontainer et peut servir \u00e0 automatiser de nombreux processus.<\/p>\n

Nous pr\u00e9sentons ci-dessous les bases de la configuration de l’API.<\/p>\n

Les informations de cet article sont techniques et s’adressent aux d\u00e9veloppeurs charg\u00e9s de la configuration de l’API. Si vous avez des questions, n’h\u00e9sitez pas \u00e0 nous contacter.<\/p>\n

Rendez-vous sur la page d’int\u00e9gration de Kontainer<\/strong> <\/a>pour en savoir plus sur notre API, notamment sur les cas d’usage et les avantages.<\/p>\n

\n

Code de l’API<\/h2>\n

Acc\u00e9dez directement au code de l’int\u00e9gration de l’API ICI<\/strong><\/a>.<\/span> <\/span><\/p>\n

\u00c0 NOTER :<\/strong> vous devez utiliser l’URL propre \u00e0 votre Kontainer \u00e0 la place de celle des exemples des liens ci-dessus (\u00ab app.kontainer.com \u00bb).<\/em><\/p>\n<\/blockquote>\n

\n

Pour commencer<\/h2>\n

Pour utiliser l’API Kontainer, vous avez besoin d’un compte Kontainer et d’un jeton d’acc\u00e8s \u00e0 l’API.<\/p>\n

Contactez votre administrateur local ou le support Kontainer<\/a> pour savoir comment obtenir un acc\u00e8s \u00e0 l’API Kontainer.<\/p>\n

Authentification<\/h3>\n

L’API Kontainer utilise OAuth<\/em> pour l’authentification. Une fois que vous avez re\u00e7u un jeton d’acc\u00e8s \u00e0 l’API, vous devez le transmettre dans chaque requ\u00eate, dans l’en-t\u00eate Authorization, avec la valeur \u00ab Bearer \u00bb.<\/p>\n

Toutes les requ\u00eates doivent contenir votre jeton d’acc\u00e8s \u00e0 l’API dans l’en-t\u00eate Authorization : Authorization: Bearer {{access-token}}<\/code><\/mark><\/p>\n

N\u00e9gociation de contenu<\/h3>\n

Toutes les requ\u00eates doivent<\/strong> inclure l’en-t\u00eate : Accept: application\/vnd.api+json <\/code><\/mark>.
Les requ\u00eates qui envoient des donn\u00e9es JSON doivent<\/strong> inclure l’en-t\u00eate : Content-Type: application\/vnd.api+json <\/code><\/mark><\/p>\n

Standard JSON:API<\/h3>\n

L’API Kontainer est une API RESTful<\/em> qui suit le standard JSON API<\/a>. Vous pouvez vous r\u00e9f\u00e9rer \u00e0 ce standard pour en savoir plus sur la structure des documents de requ\u00eate et de r\u00e9ponse.<\/p>\n

Types de ressources<\/h2>\n

L’API expose les types de ressources suivants : 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 et job logs.<\/p>\n

Op\u00e9rations d’\u00e9criture<\/h2>\n

L’API prend en charge les op\u00e9rations d’\u00e9criture sur l’ensemble des ressources : POST<\/strong> pour cr\u00e9er, PATCH<\/strong> pour modifier et DELETE<\/strong> pour supprimer. Elle n’est pas en lecture seule.<\/p>\n

Limites de d\u00e9bit<\/h3>\n

Les limites de d\u00e9bit standard de l’API s’appliquent \u00e0 tous les points d’acc\u00e8s que nous proposons, et la limite est de 500<\/code><\/mark> requ\u00eates par minute. Si vous d\u00e9passez la limite d\u00e9finie, l’API r\u00e9pond avec le message : 429: Too Many Attempts<\/code><\/mark>.<\/p>\n

Codes de r\u00e9ponse<\/h3>\n

L’API Kontainer r\u00e9pond avec des codes d’\u00e9tat HTTP et des codes et messages d’erreur au format JSON.<\/p>\n

Codes d’\u00e9tat HTTP<\/h3>\n

Le tableau suivant donne un aper\u00e7u des codes d’\u00e9tat HTTP renvoy\u00e9s.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Code d’\u00e9tat HTTP<\/strong><\/th>\nTexte<\/strong><\/th>\nDescription<\/strong><\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\nOK<\/td>\nSucc\u00e8s.<\/td>\n<\/tr>\n
201<\/td>\nCreated<\/td>\nObjet cr\u00e9\u00e9.<\/td>\n<\/tr>\n
204<\/td>\nNo Content<\/td>\nAucun contenu renvoy\u00e9.<\/td>\n<\/tr>\n
401<\/td>\nUnauthorized<\/td>\nLe jeton est manquant ou invalide.<\/td>\n<\/tr>\n
403<\/td>\nForbidden<\/td>\nRessource ou requ\u00eate non prise en charge.<\/td>\n<\/tr>\n
404<\/td>\nNot Found<\/td>\nObjet introuvable.<\/td>\n<\/tr>\n
406<\/td>\nNot Acceptable<\/td>\nRequ\u00eate non acceptable.<\/td>\n<\/tr>\n
409<\/td>\nConflict<\/td>\nConflit d’\u00e9tat de l’application ou de la ressource.<\/td>\n<\/tr>\n
422<\/td>\nValidation Error<\/td>\nErreur de validation.<\/td>\n<\/tr>\n
429<\/td>\nToo Many Requests<\/td>\nLimite de d\u00e9bit d\u00e9pass\u00e9e.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Messages d’erreur<\/h3>\n

L’exemple suivant illustre l’aspect d’un message d’erreur pour le code d’\u00e9tat HTTP 401 - Unauthorized<\/code><\/mark>.<\/p>\n

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

Filtres<\/h2>\n

Vous pouvez appliquer des filtres aux points d’acc\u00e8s qui les prennent en charge, pour limiter les r\u00e9sultats renvoy\u00e9s. Les filtres s’appliquent avec le param\u00e8tre de requ\u00eate filter<\/code><\/mark>. Les champs de filtre pris en charge figurent dans la section Filter Attributes<\/strong> de chaque point d’acc\u00e8s.<\/p>\n

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

Obtenir une liste d’\u00e9l\u00e9ments ou de produits d’une cat\u00e9gorie :<\/p>\n

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

Trouver des \u00e9l\u00e9ments par EAN exact :<\/p>\n

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

Trouver des \u00e9l\u00e9ments post\u00e9rieurs \u00e0 une date donn\u00e9e :<\/p>\n

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

Trouver des \u00e9l\u00e9ments dont le co\u00fbt unitaire est sup\u00e9rieur ou \u00e9gal \u00e0 22,50 et inf\u00e9rieur \u00e0 50,00 :<\/p>\n

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

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

V\u00e9rifier si des fichiers sont r\u00e9f\u00e9renc\u00e9s dans un champ de donn\u00e9es PIM :<\/p>\n

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

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

Qualificateurs de filtre<\/strong><\/p>\n