/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

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.

Unterstützte API-Funktionen

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