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. Sie können damit:
Ihre bestehenden Kataloge und zusätzliche Quellen abrufen
Katalogstrukturen und Attribute auslesen
Einzelne Produkte oder Produktgruppen auflisten, abrufen, erstellen, aktualisieren und löschen
Ihre Produktdaten kontinuierlich mit Ihren Systemen (PIM, ERP, individuelle Tools) synchronisieren
Die Kataloge-API unterstützt NICHT das Erstellen von Katalogen. Sie kann nur zum Aktualisieren und Modifizieren bestehender Kataloge verwendet werden.
Die Katalogstruktur muss zuerst auf der Lengow-Plattform erstellt werden, bevor sie über die API verwaltet werden kann.
Unterstützte API-Funktionen
| Funktion | Status |
|---|---|
| Kataloge | |
| Kataloge und zusätzliche Quellen auflisten | ✅ Unterstützt |
| Katalog- oder Zusatzquellen-Metadaten nach catalogue_id abrufen | ✅ Unterstützt |
| Katalog erstellen | ❌ Nicht unterstützt |
| Katalog aktivieren, deaktivieren, löschen | ❌ Nicht unterstützt |
| Segment auslesen | ❌ Nicht unterstützt |
| Produkte | |
| Produkte in einem Katalog auflisten | ✅ Unterstützt |
| 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 |
Zentrale Konzepte
- catalogue_id
API-Anfragen müssen auf einen bestimmten Katalog mit seiner "catalogue_id" abzielen.
- Kataloge auflisten ist in der Regel der erste Endpunkt, der aufgerufen wird, 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 nachfolgenden 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": "Main Catalogue",
"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
Wenn Sie einen Produkt-Endpunkt aufrufen (zum Beispiel Produkt abrufen), müssen Sie den Produkt-ID-Wert angeben, der im Katalogfeld gespeichert ist, das als product_id_key definiert wurde.
API-Endpunkte Übersicht
| Operation | Zweck des Endpunkts | Typischer Anwendungsfall | Verhalten |
|---|---|---|---|
| Kataloge | |||
| Kataloge auflisten | Alle Kataloge und zusätzliche Quellen im Konto abrufen | Die catalogue_id eines Katalogs erhalten | Gibt alle im Konto zugänglichen Kataloge zurück |
| Katalog abrufen | Katalogdetails nach catalogue_id abrufen | Den product_id_key eines Katalogs erhalten | - Gibt Kataloginformationen wie Name, Status, product_id_key usw. zurück - Zeigt letzte Aktualisierung (durch Benutzer) und letzte Indexierung (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 eines Katalogs abrufen | Katalogdaten durchsuchen oder exportieren | - Gibt die im Katalog verfügbaren Produkte einschließlich aller Attributwerte für jedes Produkt zurück - Optimierungsregeln, die in der Lengow-Plattform hinzugefügt wurden, werden nicht angezeigt |
| Produkt abrufen | Einzelnes Produkt nach product_id_key abrufen | Produkt prüfen 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 Neusynchronisation des Katalogs | - Purge & Replace: überschreibt bestehende Daten - product_id_key erforderlich - Verfügbar im Einzel- oder Bulk-Modus |
| Teilaktualisierung Produkte | Nur ausgewählte Produktfelder aktualisieren | Preis- & 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 |