Wir bieten Dir verschiedene APIs an. Wenn Du ein Channel Pilot Pro Kundenkonto hast, kannst Du sie kostenlos nutzen.
Produkt API
Die Produkt API verbindet Deine Produktdatenbank, Dein Shopsystem oder Dein ERP direkt mit Channel Pilot Pro — ganz ohne zusätzliche Zwischenprozesse.
Channel Pilot Pro bietet eine eigene REST-API für den Import Deiner Produktdaten.
Diese Produkt API stellt grundlegende Funktionen wie das Erstellen, Aktualisieren und Löschen von Produktdaten bereit.
Sie kann – wie ein normaler Import – in Deinen bestehenden Importprozess integriert werde, oder diesen sogar komplett ersetzen.
Im Gegensatz zu anderen Importmethoden werden die Daten über die Produkt API aktiv von Deinem System zu Channel Pilot Pro gesendet, statt von Channel Pilot Pro abgerufen zu werden. Dadurch kannst Du genauer bestimmen, wann bestimmte Daten importiert werden sollen.
Die Produkt API speichert Daten inkrementell und ermöglicht Aktualisierungen, selbst wenn vollständige Produktfeed-Dateien verwendet werden.
Dadurch werden Anwendungsfälle wie höhere Performance und Skalierbarkeit für große Kataloge, nahezu Echtzeit‑Updates von Beständen und Preisen sowie eine vereinfachte System‑zu‑System‑Integration (ERP/PIM/WMS) ohne Dateierstellung oder -übertragung unterstützt.
Die aktuelle Version der vollständigen Produkt API Dokumentation findest Du hier.
Zur Authentifizierung benötigst Du die apiMerchantId und den apiToken, die Du in den Shop‑Einstellungen findest.
Alle Datenübertragungen über die Produkt API sind individuell auf jeden Shop und jeden Feed zugeschnitten.
Wenn Du Daten in mehreren Feeds oder Shops aktualisieren möchtest, sende für jede Shop‑Feed‑Kombination eine eigene Anfrage.
Grundlagen der Produkt API
So wie Channel Pilot Pro Dir eine REST-API zur automatisierten Steuerung Deiner Marketingaktivitäten bietet, ist es auch möglich, jeden Import über die Produkt API anzubinden.
Innerhalb der Produkt API stehen Dir folgende Funktionen zur Verfügung:
POST AUTHENTIFICATION → Identifikation der Verbindung und Erzeugung eines Tokens
Manipulation von Produktdaten
PUT / PUT_OR_CREATE (Neue Daten → Aktualisieren)
PATCH / PATCH_OR_CREATE (Zusätzliche Daten → Ersetzen)
DELETE
GET SETUP FOR FEEDS → Informationen über das Setup
Wichtiger Hinweis
Alle Übertragungen über die Produkt API sind Shop- und Feed-spezifisch.
Wenn Daten in mehreren Feeds oder Shops geändert werden sollen, muss für jede Shop-Feed-Kombination eine eigene Anfrage gestellt werden!
Import über die Produkt API
Klicke bei „Importquelle“ auf „Produkt API“.
Als Nächstes musst Du den „Eindeutigen Artikelbezeichner“ eingeben, der als SKU verwendet wird.
Er muss in Deiner Importquelle nicht zwingend „SKU“ heißen.
Klicke auf „Weiter“.
Klicke auf „Alle speichern“.
Direkt danach wird Dir der Link zu unserer offiziellen Swagger-Dokumentation für die Produkt API angezeigt.
POST Authentication – Erstellung eines „Bearer Tokens“
POST /authentication/login
Nutze diese Anfrage mit der richtigen apiMerchantId und dem apiToken als JSON-Body, um ein Authentifizierungs-Token zu erhalten, der eine Stunde gültig ist.
Dieser Token wird für alle weiteren Anfragen benötigt. Diese Informationen findest Du in den Shop-Einstellungen.
Request:
{
"apiMerchantId": "string",
"apiToken": "string"
}
Response:
{
"apiMerchantId": "string",
"apiToken": "string"
}
Offsets in API Funktionen nutzen
Jeder Feed, den Du verbindest, hat seine eigene unabhängige Offset‑Sequenz. Das Offset beginnt bei 0 und erhöht sich um 1, jedes Mal wenn ein Produkt‑Update zu diesem speziellen Feed hinzugefügt wird. Wenn Du eine API‑Anfrage machst, kannst Du das Offset nutzen, um zu steuern, welche Updates Du abrufst.
Eine einfache Möglichkeit zu prüfen, wie weit Deine Verarbeitung fortgeschritten ist, besteht darin, den endOffset-Wert anzusehen, der in Deiner jüngsten Anfrage zurückgegeben wurde. Wenn der letzte Offset in der Antwort bereits von Dir verarbeitet wurde, bedeutet das, dass alle früheren Updates ebenfalls abgeschlossen sind. Dadurch sind Offsets eine zuverlässige Methode, um inkrementelle Updates zu verfolgen und sicherzustellen, dass nichts übersehen wird.