Jetzt kaufen API-Leitfaden

Jetzt kaufen API-Leitfaden

Der folgende Leitfaden soll Entwickler dabei unterstützen, zu verstehen, wie die omacro Sofortkauf-Dienste funktionieren, um eine benutzerdefinierte Front-End-Lösung zu entwickeln. Wenn Sie mit dieser Art der Entwicklung nicht vertraut sind, wird dringend empfohlen, die vorgefertigte Lösung von omacro zu verwenden. Um mehr über „Jetzt kaufen“ zu erfahren, lesen Sie bitte unseren „Jetzt kaufen“-Implementierungsleitfaden für Lieferanten .

Voraussetzungen

Konfigurieren Sie das Netzwerk, um Jetzt kaufen zu unterstützen

Es kann erforderlich sein, sicherzustellen, dass Ihre Netzwerk-Firewall ordnungsgemäß konfiguriert ist, um mit den omacro-Webdiensten außerhalb Ihres Netzwerks zu kommunizieren. Erfahren Sie mehr über die Informationen zum Sofortkauf-Service für Netzwerkprofis .

Überblick

Die „Jetzt kaufen“-Dienstendpunkte können aufgerufen werden, um grundlegende Kundeninformationen, „Jetzt kaufen“-Konfigurationsdaten sowie Händler- und Produktinformationen anzufordern. In diesem Leitfaden werden diese Endpunkte und ihre Funktionen beschrieben.

Endpunktadresse der omacro Service Base

  1. https://services-v2.omacro.com/buynow/

In Endpunkten verwendete variable Begriffe

Bitte beachten Sie, dass Sie zum Aufrufen der meisten Jetzt-kaufen-Endpunkte möglicherweise die folgenden Schlüsselparameter angeben müssen:
  • companyId – Die interne globale eindeutige Kennung, die Ihrem Unternehmen von omacro zugewiesen wurde (auch bekannt als „omacro ID“ oder Unternehmens-GUID). Den Parameter companyId finden Sie auf der Seite Buy Now -> Site Code oder indem Sie auf Ihren Firmennamen in der oberen linken Ecke des Omacro-Navigationsmenüs klicken. Die companyId erscheint im URL-Parameter „id“.
  • productId – Die interne globale eindeutige Kennung, die Ihrem Produkt von omacro zugewiesen wurde (auch bekannt als Produkt-GUID). Zu diesem Zeitpunkt finden Sie den Parameter productId auf der Seite omacro- Produkte -> Produkt verwalten , indem Sie auf das Produktmodell klicken und die Seite „Live“ aufrufen. Die Produkt-ID erscheint in der URL als Parameter "p".

Endpunkte

Datenabruf
  • geolokalisieren
  • Unternehmen/ {companyId:guid}
  • Unternehmen/ {companyId:guid} /retailers/online
  • Unternehmen/ {companyId:guid} /retailers/local
  • Unternehmen/ {Firmen-ID: GUID} / validieren
  • Unternehmen/ {Unternehmens-ID: GUID} / Produkte
  • Unternehmen/ {companyId:guid} /products/ {productId:guid} /retailers/online
  • Unternehmen/ {companyId:guid} /products/ {productId:guid} /retailers/local
Analytisches Tracking
  • Händlertransaktion
  • Produkttransaktion
  • Produkttransaktioneneinfach
  • Händlertransaktioneneinfach

Das Folgende ist ein Beispiel für eine vollständig qualifizierte Endpunktadresse: