Shop per API anbinden
Nutzen Sie die Partner-API, wenn Ihr Shop auf einem eigenen System läuft oder Sie die Synchronisation vollständig steuern möchten. Sie senden Produkt-Batches an Aura Historia, wir verarbeiten sie im Hintergrund, und die Produkte erscheinen kurz darauf auf Ihrer Shop-Seite.
Die API bestätigt, dass Ihr Batch eingegangen ist. Validierung, Verarbeitung und Veröffentlichung laufen danach im Hintergrund. Eine 202-Antwort bedeutet also: Der Import wurde gestartet, nicht dass alle Produkte bereits sichtbar sind.
Typischer Ablauf
Importe asynchron behandeln
Senden Sie ein Batch, speichern Sie die Annahmeantwort und prüfen Sie das Ergebnis nach der Verarbeitung auf Ihrer Aura-Historia-Shop-Seite.
Klein starten, dann aktuell halten
Nutzen Sie POST für das erste Produkt-Batch. Sobald der Import funktioniert, halten Sie Ihren Katalog mit PATCH-Updates oder PUT-Upserts aktuell.
Diese drei Angaben reichen aus, um ein erstes, gut prüfbares Produkt-Batch zu senden.
Partnerzugang und API-Key
Beantragen Sie den Zugang über unser Partner-Team. Nach der Freigabe erhalten Sie einen auf Ihren Shop begrenzten API-Key.
Ihre Aura-Historia-Shop-ID
Verwenden Sie die Shop-ID aus dem Onboarding in jedem Batch-Request, damit Produkte dem richtigen Shop zugeordnet werden.
Ein kleines Produkt-Batch
Starten Sie mit wenigen validen Produkten, damit Sie Import, Datenzuordnung und veröffentlichtes Ergebnis schnell prüfen können.
Vom API-Key zum ersten Produkt-Sync
Ein praktischer Ablauf, um ein eigenes Shopsystem mit Aura Historia zu verbinden.
Schritt 1
Zugang für Ihren Partner-Shop anfragen
Starten Sie mit dem Partner-Onboarding. Nach der Freigabe Ihres Shops erhalten Sie den API-Key und die Shop-ID für Batch-Requests.
Worauf Sie achten sollten
Halten Sie API-Key, Shop-ID und Onboarding-Kontakt so bereit, dass Ihr Integrationsteam sicher darauf zugreifen kann.
Freischaltung und Zugangsdaten
API-Key und Shop-IDSchritt 2
Ersten Produkt-Payload vorbereiten
Erstellen Sie ein kleines Batch mit den erforderlichen Produktfeldern. Prüfen Sie IDs, Titel, Preise, Bilder, Verfügbarkeit und Links zu Ihren Produktseiten.
Worauf Sie achten sollten
Beginnen Sie mit wenigen Produkten. Das macht die Validierung übersichtlicher und den ersten Import leichter zu debuggen.
JSON-Payload vorbereiten
Batch-Struktur und PflichtfelderSchritt 3
Erstes Batch senden
Senden Sie das Batch per POST an den Partner-Endpunkt. Sobald der Request angenommen wird, startet die Verarbeitung im Hintergrund.
Relevanter Endpunkt
POST /api/v1/shops/{shopId}/productsWorauf Sie achten sollten
Eine erfolgreiche Annahmeantwort bedeutet nicht, dass die Produkte sofort sichtbar sind. Planen Sie einige Minuten Verarbeitungszeit ein.
Produkt-Batch senden
Request und 202-AntwortSchritt 4
Katalog aktuell halten
Nach dem ersten erfolgreichen Import nutzen Sie PATCH für gezielte Änderungen oder PUT, wenn Ihre Synchronisation vollständige Datensätze anlegt oder aktualisiert.
Relevanter Endpunkt
PATCH /api/v1/shops/{shopId}/products · PUT /api/v1/shops/{shopId}/productsWorauf Sie achten sollten
Nutzen Sie PATCH für bekannte Änderungen und PUT für Upserts, wenn ein Batch neue und bestehende Produkte enthalten kann.
Sync aktualisieren
Update- und Upsert-AktionenSchritt 5
Shop-Seite öffnen und Ergebnis prüfen
Öffnen Sie nach der Verarbeitung Ihre Aura-Historia-Shop-Seite. Die ersten synchronisierten Produkte sollten dort nach kurzer Verzögerung erscheinen.
Relevanter Endpunkt
/shops/{shopSlugId}Worauf Sie achten sollten
Nutzen Sie Ihren Shop-Slug, um direkt zur öffentlichen Shop-Seite zu springen und die importierten Produkte zu prüfen.
Tragen Sie den Shop-Slug aus Ihrer Aura-Historia-Shop-URL ein. Der Button öffnet direkt die öffentliche Shop-Seite.
Shop-Seite prüfen
Produktgrid und Shop-HeaderPartner-Produkt-API-Referenz
Die eingebettete OpenAPI-Referenz konzentriert sich auf die Batch-Endpunkte, die Sie für eine eigene Integration brauchen.
Partner-Produkt-API-Referenz