Konten ohne Beta-Zugang erhalten eine 403 Forbidden-Antwort.
/catalogues
Dieser Endpunkt der Lengow API ermöglicht es Ihnen, Ihre Produktkataloge zu verwalten, ohne auf manuelle Importe oder UI-basierte Aktualisierungen angewiesen zu sein. Er erlaubt Ihnen:
Ihre bestehenden Kataloge und zusätzliche Quellen abzurufen
Katalogstrukturen und Attribute auszulesen
Einzelne Produkte oder Produktgruppen aufzulisten, abzurufen, zu erstellen, zu aktualisieren und zu löschen
Ihre Produktdaten kontinuierlich von Ihren Systemen (PIM, ERP, kundenspezifische Tools) synchronisiert zu halten
Die Katalog-API unterstützt NICHT die Erstellung von Katalogen. Sie kann nur verwendet werden, um bestehende Kataloge zu aktualisieren und zu ändern.
Die Katalogstruktur muss zuerst auf der Lengow-Plattform erstellt werden, bevor sie über die API verwaltet werden kann.
Sie können Ihren Katalog über die API aktualisieren und dabei die eingestellte geplante Indexierungsfrequenz in der Lengow-Plattform je nach Bedarf beibehalten.
Wichtig: Wenn eine geplante Indexierung ausgelöst wird, überschreibt sie alle zuvor über die API vorgenommenen Aktualisierungen.
Testen der Katalog-API in der Lengow Sandbox
Sie können die Lengow Sandbox nutzen, um die Katalog-API zu testen, indem Sie hier ein Sandbox-Konto eröffnen: https://my.lengow.net/registration
Fügen Sie in Ihrem Sandbox-Konto Ihren Katalog hinzu. Kontaktieren Sie dann das Support-Team von Lengow, um Zugang zur Katalog-API zu beantragen (geben Sie Ihre Sandbox-Konto-ID im Ticket an).
API-Aufrufe können durchgeführt werden, indem die .net (Sandbox)-Umgebung anstelle der üblichen .io (Produktion) angesprochen wird.
API-Dokumentation: https://api.lengow.io/docs/
Unterstützte API-Funktionen
| Funktion | Status |
|---|---|
| Kataloge | |
| Kataloge und zusätzliche Quellen auflisten | ✅ Unterstützt |
| Katalog- oder zusätzliche Quell-Metadaten nach catalogue_id abrufen | ✅ Unterstützt |
| Einen Katalog erstellen | ❌ Nicht unterstützt |
| Einen Katalog aktivieren, deaktivieren, löschen | ❌ Nicht unterstützt |
| Segment auslesen | ❌ Nicht unterstützt |
| Produkte | |
| Produkte in einem Katalog auflisten | ✅ Unterstützt |
| Ein Produkt nach product_id_key abrufen | ✅ Unterstützt |
| Produkte erstellen oder ersetzen (einzeln oder in Bulk) | ✅ Unterstützt |
| Teilaktualisierung eines Produkts oder einer Produktgruppe (einzeln oder in Bulk) | ✅ Unterstützt |
| Produkte löschen (einzeln oder in Bulk) | ✅ Unterstützt |
| Optimierungsregeln in Produktdaten abrufen | ❌ Nicht unterstützt |
| Attribute | |
| Attribute in einem Katalog oder einer zusätzlichen Quelle auflisten | ✅ Unterstützt |
| Attribute erstellen | ❌ Nicht unterstützt |
| Attribute aktualisieren | ❌ Nicht unterstützt |
| Attribute löschen | ❌ Nicht unterstützt |
| Attribute aus zusätzlichen Quellen über den Hauptkatalog auflisten | ❌ Nicht unterstützt |
Schlüsselkonzepte
- catalogue_id
API-Anfragen müssen auf einen bestimmten Katalog mit seiner "catalogue_id" abzielen.
- Kataloge auflisten ist in der Regel der erste aufzurufende Endpunkt, da er eine Liste aller Hauptkataloge und zusätzlichen Quellen im Konto zurückgibt. Er enthält die "catalogue_id" für jeden Katalog, die für alle weiteren Anfragen verwendet wird.
- Katalog abrufen verwendet die "catalogue_id", um die Metadaten eines Hauptkatalogs oder einer zusätzlichen Quelle zurückzugeben (wie Name, Status, product_id_key usw.).
Beispielantwort für GET /catalogues/{catalogue_id} :
{
"catalogue_id": 95000,
"name": "Hauptkatalog",
"status": "enabled",
"product_id_key": "id_product",
"created_at": "2024-09-11T10:42:28.661555Z",
"updated_at": "2025-11-06T13:57:48.078126Z",
"indexed_at": "2025-11-06T13:57:49.571801Z",
"source": "link",
"products_count": 2134
}- product_id_key
Alle produktbezogenen API-Operationen basieren auf dem "product_id_key" (siehe Antwort oben).
Der "product_id_key" wird in Ihren Katalogeinstellungen in Lengow definiert und identifiziert das Feld, das die eindeutige Produkt-ID enthält.
Weitere Informationen finden Sie unter Initiale Produktattribut-Zuordnung
Beim Aufruf eines Produktendpunkts (z. B. Produkt abrufen) müssen Sie den Produkt-ID-Wert angeben, der im Katalogfeld gespeichert ist, das als product_id_key definiert wurde.
Übersicht der API-Endpunkte
| Operation | Zweck des Endpunkts | Typischer Anwendungsfall | Verhalten |
|---|---|---|---|
| Kataloge | |||
| Kataloge auflisten | Alle Kataloge und zusätzlichen Quellen im Konto abrufen | catalogue_id eines Katalogs erhalten | Gibt alle im Konto zugänglichen Kataloge zurück |
| Katalog abrufen | Katalogdetails anhand der catalogue_id abrufen | product_id_key eines Katalogs erhalten | - Gibt Kataloginformationen wie Name, Status, product_id_key usw. zurück - Zeigt letzte Aktualisierung (Benutzermodifikation) und letzte Indexierung (Abruf durch Lengow) an |
| Attribute | |||
| Attribute auflisten | Liste der Attribute für einen Katalog abrufen | Katalogstruktur verstehen | - Gibt alle im Katalog vorhandenen Feldnamen zurück - Attribute aus zusätzlichen Quellen werden im Hauptkatalog nicht angezeigt |
| Produkte | |||
| Produkte auflisten | Alle Produkte aus einem Katalog abrufen | Katalogdaten durchsuchen oder exportieren | - Gibt verfügbare Produkte im Katalog zurück, einschließlich aller Attributwerte für jedes Produkt - Optimierungsregeln, die in der Lengow-Plattform hinzugefügt wurden, werden nicht angezeigt |
| Produkt abrufen | Ein einzelnes Produkt anhand des product_id_key abrufen | Produkt inspizieren oder debuggen | - Gibt alle Attributwerte für ein einzelnes Produkt zurück - product_id_key erforderlich |
| Produkte erstellen oder ersetzen | Produktdaten erstellen oder vollständig überschreiben | Vollständige Katalogresynchronisation | - Löschen & Ersetzen: überschreibt bestehende Daten - product_id_key erforderlich - Verfügbar im Einzel- oder Bulk-Modus |
| Produkte teilweise aktualisieren | Nur ausgewählte Produktfelder aktualisieren | Preis- und Lagerbestandsaktualisierungen | - Aktualisiert nur angegebene Felder (nicht angegebene Felder bleiben unverändert) - product_id_key erforderlich - Verfügbar im Einzel- oder Bulk-Modus |
| Produkte löschen | Produkte aus dem Katalog löschen | Veraltete Produkte entfernen | - Löscht Produkte basierend auf product_id_key - Verfügbar im Einzel- oder Bulk-Modus |