/catalogues

Dieser Endpunkt der Lengow API ermöglicht es Ihnen, Ihre Produktkataloge zu verwalten, ohne sich auf manuelle Importe oder UI-basierte Updates zu verlassen. Es ermöglicht Ihnen:

• Rufen Sie Ihre bestehenden Kataloge und zusätzlichen Quellen ab

• Lesen Sie Katalogstrukturen und Attribute

• Auflisten, Abrufen, Erstellen, Aktualisieren und Löschen eines einzelnen Produkts oder einer Gruppe von Produkten

• Halten Sie Ihre Produktdaten kontinuierlich synchronisiert von Ihren Systemen (PIM, ERP, benutzerdefinierte Tools)

API-Updates und Katalogsynchronisation

Wenn ein Produkt über die Katalog-API aktualisiert wird, wird die Änderung sofort innerhalb von Lengow angewendet. Je nach Ihrer Datenarchitektur können Sie wählen, wie die API mit Ihren Standardkatalogimporten interagiert:

Option 1: API-Updates + Geplante Katalogimporte

Wenn Ihr Katalog auch durch einen geplanten Dateiimport synchronisiert wird, bleibt die nächste Dateiaktualisierung die maßgebliche Datenquelle und wird die Produktinformationen überschreiben mit den Werten, die in der neuesten Datei enthalten sind.

In der Praxis ist dies ein ausgezeichneter Workflow, solange die Produktdaten in Ihrer Quelldatei aktuell sind. Dieser hybride Mechanismus ermöglicht es Ihnen, dringende Daten (wie Lagerabfälle) tagsüber über die API zu pushen, während ein nächtliches Update sicherstellt, dass Ihr Katalog vollständig mit Ihrer primären Datenquelle abgestimmt bleibt und Konsistenz über alle Produkte gewährleistet.

Option 2: Nur API-Updates

• ✓ Echtzeit-Produktupdates
• ✓ Keine geplante Abstimmung

Wenn Sie keine routinemäßige dateibasierte Abstimmung benötigen und möchten, dass die API Ihr einziges Mittel zur Katalogverwaltung ist, können Sie geplante Updates vollständig entfernen. Um diesen Modus zu verwenden, lassen Sie einfach den Katalogsynchronisationsplan in der Lengow-Schnittstelle leer.

Unterstützte API-Funktionen

Schlüsselkonzepte

- catalogue_id

API-Anfragen müssen einen bestimmten Katalog mit seiner "catalogue_id" anvisieren.

• Kataloge auflisten ist in der Regel der erste Endpunkt, der aufgerufen wird, da er eine Liste aller Hauptkataloge und zusätzlichen Quellen auf dem Konto zurückgibt. Es enthält die "catalogue_id" für jeden einzelnen, die für alle nachfolgenden Anfragen verwendet wird. 
• Katalog abrufen verwendet die "catalogue_id", um die Metadaten eines Hauptkatalogs oder einer zusätzlichen Quelle (wie seinen Namen, Status, product_id_key, usw.) zurückzugeben.

Beispielantwort für GET /catalogues/{catalogue_id} :

{
    "catalogue_id": 95000,
    "name": "Hauptkatalog",
    "status": "aktiviert",
    "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" (wie in der obigen Antwort gezeigt).

Der "product_id_key" ist in Ihren Katalogeinstellungen in Lengow definiert und identifiziert das Feld, das die eindeutige Produkt-ID enthält. 
Für weitere Informationen siehe Erste Produktattributzuordnung

Wenn Sie einen Produktendpunkt aufrufen (zum Beispiel Produkt abrufen), müssen Sie den Produkt-ID-Wert angeben, der im Katalogfeld als product_id_key definiert ist.
 

Übersicht über die API-Endpunkte