Konten ohne Beta-Zugang erhalten eine 403 Forbidden-Antwort.
/catalogues
Dieser Endpunkt der Lengow API ermöglicht es Ihnen, Ihre Produktkataloge zu verwalten, ohne sich auf manuelle Importe oder UI-basierte Aktualisierungen zu verlassen. Er ermöglicht Ihnen:
Abrufen Ihrer bestehenden Kataloge und zusätzlichen Quellen
Lesen von Katalogstrukturen und Attributen
Auflisten, Abrufen, Erstellen, Aktualisieren und Löschen eines einzelnen Produkts oder einer Gruppe von Produkten
Halten Sie Ihre Produktdaten kontinuierlich mit Ihren Systemen (PIM, ERP, benutzerdefinierte Tools) synchronisiert
Die Kataloge-API unterstützt NICHT die Erstellung von Katalogen. Sie kann nur zum Aktualisieren und Ändern 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 lesen | ❌ 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 gesammelt) | ✅ Unterstützt |
| Teilaktualisierung eines Produkts oder einer Gruppe von Produkten (einzeln oder gesammelt) | ✅ Unterstützt |
| Produkte löschen (einzeln oder gesammelt) | ✅ 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 von 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 Endpunkt, der aufgerufen wird, da er eine Liste aller Hauptkataloge und zusätzlichen Quellen im Konto zurückgibt. Er enthält die für jeden, 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 kennzeichnet das Feld, das die eindeutige Produkt-ID enthält.
Weitere Informationen finden Sie unter Initiales Mapping der Produktattribute
Wenn Sie einen Produkt-Endpunkt aufrufen (z. B. Produkt abrufen), müssen Sie den Produkt-ID-Wert angeben, der im Katalogfeld gespeichert ist, das als product_id_key definiert ist.
API-Endpunkt-Übersicht
| Operation | Endpunkt-Zweck | 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 (Änderung durch Benutzer) 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 im Katalog verfügbare Produkte zurück, einschließlich aller Attributwerte für jedes Produkt - Optimierungsregeln, die in der Lengow-Plattform hinzugefügt wurden, werden nicht angezeigt |
| Produkt abrufen | Einzelnes Produkt nach 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 Katalog-Resynchronisation | - Purge & Replace: Überschreibt bestehende Daten - product_id_key erforderlich - Verfügbar im Einzel- oder Sammelmodus |
| Produkte teilweise aktualisieren | 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 Sammelmodus |
| 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 Sammelmodus |