{"id":6870,"date":"2023-03-14T08:55:39","date_gmt":"2023-03-14T07:55:39","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/article\/kontainer-api-integration\/"},"modified":"2026-06-15T14:29:32","modified_gmt":"2026-06-15T12:29:32","slug":"kontainer-api-integration","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/de\/article\/kontainer-api-integration\/","title":{"rendered":"Kontainer API Integration"},"content":{"rendered":"

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

Die Kontainer API erm\u00f6glicht eine einfache Integration Ihrer bestehenden Software in die Kontainer-Plattform. Diese Software-zu-Software-Schnittstelle erlaubt es Ihren Anwendungen, Daten mit Kontainer auszutauschen, und kann zur Automatisierung vieler unterschiedlicher Prozesse genutzt werden.<\/p>\n

Im Folgenden gehen wir die Grundlagen der API-Einrichtung durch.<\/p>\n

Die Informationen in diesem Artikel sind technischer Natur und richten sich an Entwickler, die f\u00fcr die API-Einrichtung verantwortlich sind. Wenn Sie Fragen haben, melden Sie sich gerne bei uns.<\/p>\n

Besuchen Sie die Kontainer-Integrationsseite<\/strong><\/a>, um mehr \u00fcber unsere API zu erfahren. Dort finden Sie weitere Informationen zu Anwendungsf\u00e4llen, Vorteilen usw.<\/p>\n

\n

API-Code<\/h2>\n

Direkt zum Code f\u00fcr die API-Integration gelangen Sie HIER<\/strong><\/a>.<\/span> <\/span><\/p>\n

HINWEIS<\/strong>: Verwenden Sie bitte Ihre individuelle Kontainer-URL anstelle der in den oben verlinkten Beispielen verwendeten URL (\u201eapi.kontainer.com“)<\/em><\/p><\/blockquote>\n

\n

Erste Schritte<\/h2>\n

Um die Kontainer API nutzen zu k\u00f6nnen, ben\u00f6tigen Sie ein Kontainer-Konto sowie ein API-Zugriffstoken.<\/p>\n

Bitte wenden Sie sich an Ihren lokalen Administrator oder an den Kontainer Support<\/a>, um weitere Informationen zum Zugriff auf die Kontainer API zu erhalten.<\/p>\n

Authentifizierung<\/h3>\n

Die Kontainer API verwendet OAuth<\/em> zur Authentifizierung. Sobald Ihnen ein API-Zugriffstoken zur Verf\u00fcgung gestellt wurde, m\u00fcssen Sie dieses Token bei jeder Anfrage im Authorization-Header als \u201eBearer“-Wert mitsenden.<\/p>\n

Alle Anfragen m\u00fcssen Ihr API-Zugriffstoken im Authorization-Header enthalten: Authorization: Bearer {{access-token}}<\/code><\/mark><\/p>\n

Content Negotiation<\/h3>\n

Alle Anfragen m\u00fcssen<\/strong> den folgenden Header enthalten: Accept: application\/vnd.api+json <\/code><\/mark>. Anfragen, die JSON-Daten senden, m\u00fcssen<\/strong> zus\u00e4tzlich den Header enthalten: Content-Type: application\/vnd.api+json <\/code><\/mark><\/p>\n

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

Die Kontainer API ist eine RESTful<\/em> API und folgt dem JSON API<\/a>-Standard. Weitere Informationen zur Struktur von Request- und Response-Dokumenten finden Sie in dieser Spezifikation.<\/p>\n

Ressourcentypen<\/h2>\n

Die API stellt folgende Ressourcentypen bereit: 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 und job logs.<\/p>\n

Schreibende Operationen<\/h2>\n

Die API unterst\u00fctzt schreibende Operationen f\u00fcr alle Ressourcen: POST<\/strong> zum Erstellen, PATCH<\/strong> zum Aktualisieren und DELETE<\/strong> zum Entfernen. Die API ist nicht rein lesend (read-only).<\/p>\n

Rate Limits<\/h3>\n

F\u00fcr alle bereitgestellten Endpunkte gelten die standardm\u00e4\u00dfigen API-Limits. Das Limit liegt bei 500<\/code><\/mark> Anfragen pro Minute. Wird dieses Limit \u00fcberschritten, antwortet die API mit der Meldung: 429: Too Many Attempts<\/code><\/mark>.<\/p>\n

Response-Codes<\/h3>\n

Die Kontainer API antwortet mit HTTP-Statuscodes sowie JSON-basierten Fehlercodes und -meldungen.<\/p>\n

HTTP-Statuscodes<\/h3>\n

Die folgende Tabelle gibt einen \u00dcberblick \u00fcber die zur\u00fcckgegebenen HTTP-Statuscodes.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP-Statuscode<\/strong><\/th>\nText<\/strong><\/th>\nBeschreibung<\/strong><\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\nOK<\/td>\nErfolgreich.<\/td>\n<\/tr>\n
201<\/td>\nCreated<\/td>\nObjekt erstellt.<\/td>\n<\/tr>\n
204<\/td>\nNo Content<\/td>\nKein Inhalt zur\u00fcckgegeben.<\/td>\n<\/tr>\n
401<\/td>\nUnauthorized<\/td>\nToken fehlt oder ist ung\u00fcltig.<\/td>\n<\/tr>\n
403<\/td>\nForbidden<\/td>\nRessource oder Anfrage wird nicht unterst\u00fctzt.<\/td>\n<\/tr>\n
404<\/td>\nNot Found<\/td>\nObjekt nicht gefunden.<\/td>\n<\/tr>\n
406<\/td>\nNot Acceptable<\/td>\nAnfrage nicht akzeptabel.<\/td>\n<\/tr>\n
409<\/td>\nConflict<\/td>\nKonflikt im Anwendungs- oder Ressourcenstatus.<\/td>\n<\/tr>\n
422<\/td>\nValidation Error<\/td>\nValidierungsfehler ist aufgetreten.<\/td>\n<\/tr>\n
429<\/td>\nToo Many Requests<\/td>\nRate Limit \u00fcberschritten.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Fehlermeldungen<\/h3>\n

Das folgende Beispiel zeigt, wie eine Fehlermeldung f\u00fcr den HTTP-Statuscode 401 - Unauthorized<\/code><\/mark> aussehen kann. <\/picture><\/p>\n

Filter<\/h2>\n

Filter k\u00f6nnen auf unterst\u00fctzte Endpunkte angewendet werden, um die zur\u00fcckgegebenen Ergebnisse einzuschr\u00e4nken. Filter werden \u00fcber den Query-Parameter filter<\/code><\/mark> angewendet. Die unterst\u00fctzten Filterfelder finden Sie im Abschnitt Filter Attributes<\/strong> des jeweiligen Endpunkts.<\/p>\n

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

Liste von Kategorieelementen\/Produkten abrufen:<\/p>\n

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

Elemente anhand einer exakten EAN finden:<\/p>\n

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

Elemente nach einem bestimmten Datum finden:<\/p>\n

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

Elemente mit St\u00fcckkosten gr\u00f6\u00dfer oder gleich 22,50 und kleiner als 50,00 finden:<\/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

Pr\u00fcfen, ob Dateien in PIM-Datenfeld verkn\u00fcpft sind:<\/p>\n

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

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

Filter-Operatoren<\/strong><\/p>\n