--- title: "Kontainer API Integration" url: "https://helpdesk.kontainer.com/de/article/kontainer-api-integration/" type: "article" category: ["Integrationen & Plugins"] tags: ["Nur für Admins", "DAM", "PIM"] language: "de" published: "2023-03-14T07:55:39+00:00" updated: "2026-06-15T12:29:32+00:00" summary: "The Kontainer API provides an easy integration of your existing software into the Kontainer platform. This software-to-software interface allows your applications to exchange data with Kontainer and c…" --- # Kontainer API Integration ![API Integration header](https://helpdesk.kontainer.com/wp-content/uploads/2023/03/API-integration-HERO-1.png?v=1763368897) Die Kontainer API ermöglicht 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. Im Folgenden gehen wir die Grundlagen der API-Einrichtung durch. Die Informationen in diesem Artikel sind technischer Natur und richten sich an Entwickler, die für die API-Einrichtung verantwortlich sind. Wenn Sie Fragen haben, melden Sie sich gerne bei uns. Besuchen Sie die [**Kontainer-Integrationsseite**](https://kontainer.com/de/integrations/api), um mehr über unsere API zu erfahren. Dort finden Sie weitere Informationen zu Anwendungsfällen, Vorteilen usw. > ## API-Code > > > > Direkt zum Code für die API-Integration gelangen Sie [**HIER**](https://app.kontainer.com/api/documentation). > > > > ***HINWEIS**: Verwenden Sie bitte Ihre individuelle Kontainer-URL anstelle der in den oben verlinkten Beispielen verwendeten URL („api.kontainer.com")* --- ## Erste Schritte Um die Kontainer API nutzen zu können, benötigen Sie ein Kontainer-Konto sowie ein API-Zugriffstoken. Bitte wenden Sie sich an Ihren lokalen Administrator oder an den [Kontainer Support](mailto:support@kontainer.com), um weitere Informationen zum Zugriff auf die Kontainer API zu erhalten. ### Authentifizierung Die Kontainer API verwendet *OAuth* zur Authentifizierung. Sobald Ihnen ein API-Zugriffstoken zur Verfügung gestellt wurde, müssen Sie dieses Token bei jeder Anfrage im Authorization-Header als „Bearer"-Wert mitsenden. Alle Anfragen müssen Ihr API-Zugriffstoken im Authorization-Header enthalten: `Authorization: Bearer {{access-token}}` ### Content Negotiation Alle Anfragen **müssen** den folgenden Header enthalten: `Accept: application/vnd.api+json`. Anfragen, die JSON-Daten senden, **müssen** zusätzlich den Header enthalten: `Content-Type: application/vnd.api+json` ### JSON:API-Standard Die Kontainer API ist eine *RESTful* API und folgt dem [JSON API](https://jsonapi.org/)-Standard. Weitere Informationen zur Struktur von Request- und Response-Dokumenten finden Sie in dieser Spezifikation. ## Ressourcentypen 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. ## Schreibende Operationen Die API unterstützt schreibende Operationen für alle Ressourcen: **POST** zum Erstellen, **PATCH** zum Aktualisieren und **DELETE** zum Entfernen. Die API ist nicht rein lesend (read-only). ### Rate Limits Für alle bereitgestellten Endpunkte gelten die standardmäßigen API-Limits. Das Limit liegt bei `500` Anfragen pro Minute. Wird dieses Limit überschritten, antwortet die API mit der Meldung: `429: Too Many Attempts`. ### Response-Codes Die Kontainer API antwortet mit HTTP-Statuscodes sowie JSON-basierten Fehlercodes und -meldungen. ### HTTP-Statuscodes Die folgende Tabelle gibt einen Überblick über die zurückgegebenen HTTP-Statuscodes. | **HTTP-Statuscode** | **Text** | **Beschreibung** | | --- | --- | --- | | 200 | OK | Erfolgreich. | | 201 | Created | Objekt erstellt. | | 204 | No Content | Kein Inhalt zurückgegeben. | | 401 | Unauthorized | Token fehlt oder ist ungültig. | | 403 | Forbidden | Ressource oder Anfrage wird nicht unterstützt. | | 404 | Not Found | Objekt nicht gefunden. | | 406 | Not Acceptable | Anfrage nicht akzeptabel. | | 409 | Conflict | Konflikt im Anwendungs- oder Ressourcenstatus. | | 422 | Validation Error | Validierungsfehler ist aufgetreten. | | 429 | Too Many Requests | Rate Limit überschritten. | ### Fehlermeldungen Das folgende Beispiel zeigt, wie eine Fehlermeldung für den HTTP-Statuscode `401 - Unauthorized` aussehen kann. ![](https://helpdesk.kontainer.com/wp-content/uploads/2023/04/Screenshot-2023-04-04-at-10.30.42.png?v=1763368898) ## Filter Filter können auf unterstützte Endpunkte angewendet werden, um die zurückgegebenen Ergebnisse einzuschränken. Filter werden über den Query-Parameter `filter` angewendet. Die unterstützten Filterfelder finden Sie im Abschnitt **Filter Attributes** des jeweiligen Endpunkts. **Beispiele:** Liste von Kategorieelementen/Produkten abrufen: `filter[description][like]` : `Shoes` Elemente anhand einer exakten EAN finden: `filter[ean][eq]` : `4194382028137` Elemente nach einem bestimmten Datum finden: `filter[released_on][gt]` : `2020-01-01` Elemente mit Stückkosten größer oder gleich 22,50 und kleiner als 50,00 finden: `filter[unit_cost][gte]` : `22.50` `filter[unit_cost][lt]` : `50.00` Prüfen, ob Dateien in PIM-Datenfeld verknüpft sind: `filter[asset][exists]` : `1` `filter[asset][exists]` : `0` **Filter-Operatoren** - Gleich: [eq] - Enthalten in: [in] - Ähnlich: [like] - Größer als: [gt] - Größer oder gleich: [gte] - Kleiner als: [lt] - Kleiner oder gleich: [lte] - Nicht enthalten in: [notin] - Nicht gleich: [ne] *(nur für PIM**)* - Existstiert: [exists] (*nur für PIM*) **Hinweis: Die erlaubten Filter-Operatoren hängen vom jeweils durchsuchten Element ab.** ## Compound Documents [JSONAPI – Compound Documents](https://jsonapi.org/format/#document-compound-documents) Um die Anzahl der HTTP-Anfragen zu reduzieren, können bei unterstützten Endpunkten neben den angeforderten primären Ressourcen auch zugehörige Ressourcen mit ausgegeben werden. Diese sogenannten „Included Resources" werden über den Query-Parameter `include` angefordert. Die unterstützten Includes finden Sie im Abschnitt **Available Includes** des jeweiligen Endpunkts. **Beispiele:** - Im Endpunkt **GET /elements**, um die zugehörigen Elementoptionen einzuschließen: `include: element_option` - Im Endpunkt **GET /items**, um Root-, Parent- und Child-Elemente einzuschließen: `include: parent_item,root_item,children` ## Pagination Antworten werden paginiert, mit einer konfigurierbaren Seitengröße. Es werden keine Bulk-Endpunkte oder Webhooks bereitgestellt. --- > ## API-Code > > > > Direkt zum Code für die API-Integration gelangen Sie [**HIER**](https://app.kontainer.com/api/documentation). > > > > ***HINWEIS**: Verwenden Sie bitte Ihre individuelle Kontainer-URL anstelle der in den oben verlinkten Beispielen verwendeten URL („api.kontainer.com")* ## Other languages - [English](https://helpdesk.kontainer.com/article/kontainer-api-integration/index.md) ## Related articles - [Strapi-Integrationsleitfaden](https://helpdesk.kontainer.com/de/article/strapi-integrationsleitfaden/index.md): Mit der Strapi-Integration von Kontainer können Sie Bilder, Videos und Dateien ganz einfach direkt aus Ihrem DAM in das Admin-Panel von Strapi einfügen – ohne manuelles Herunter- und Hochladen. - [Slack-Benachrichtigungen von Kontainer](https://helpdesk.kontainer.com/de/article/slack-benachrichtigungen-von-kontainer/index.md): Bringen Sie Kontainer-Benachrichtigungen direkt in Slack und bleiben Sie auf dem Laufenden, ohne mehrere Systeme überwachen zu müssen. - [WordPress Integrationsleitfaden](https://helpdesk.kontainer.com/de/article/wordpress-plugin-guide/index.md): Mit der WordPress-Integration von Kontainer können Sie Bilder, Videos und Dateien direkt aus Ihrem DAM in WordPress einfügen – ganz ohne manuelles Herunterladen und Hochladen. - [Shopify-Integration Leitfaden](https://helpdesk.kontainer.com/de/article/shopify-integration-guide/index.md): Die Integration ermöglicht es Ihnen, Produktdaten, Bilder und andere digitale Assets in Kontainer zu verwalten und diese direkt mit Ihrem Shopify-Shop zu synchronisieren. Dadurch stellen Sie konsisten…