Integration des Amazon-Verkaufspartners API

Um über den Amazon-Verkaufspartner API (SP-API) auf die Daten zuzugreifen, müssen Sie die folgenden Schritte ausführen:

1. Registrieren Sie sich als API SP-Entwickler

2. APISP-Rollen anfragen

3. Registrieren Sie Ihre Bewerbung

4. Wählen Sie ein Autorisierungsmodell für Ihre Anwendung

5. Connect zum SP- her API

Registrieren Sie sich als API SP-Entwickler

Bevor Sie Ihre API SP-Anwendung registrieren können, müssen Sie ein Amazon-Entwicklerkonto erstellen und sich als API SP-Entwickler registrieren. Einen umfassenden Überblick über den Registrierungsprozess für Entwickler finden Sie unter APISP-Registration Overview in der API SP-Dokumentation.

APISP-Rollen anfragen

Eine APISP-Rolle bestimmt, ob ein Entwickler oder eine Anwendung Zugriff auf einen bestimmten Vorgang oder eine bestimmte Ressource hat. Als Entwickler müssen Sie eine bestimmte Rolle beantragen und sich dafür qualifizieren, andernfalls können Sie nicht auf die Operationen und Ressourcen zugreifen, die dieser Rolle zugeordnet sind.

Rollen schützen den Zugriff auf personenbezogene Daten (PII) und andere sensible Daten. Sie schränken den Datenzugriff ein, um sicherzustellen, dass Entwickler nur auf die Daten zugreifen können, die für ihre Anwendung erforderlich sind. Dies trägt zum Schutz der Kundendaten und zur Wahrung des Kundenvertrauens bei.

Für den Zugriff auf die in den Brand Analytics-Berichten verfügbaren Daten benötigen Sie die Brand Analytics-Rolle. Weitere Informationen zur Beantragung des Zugriffs auf eine Rolle finden Sie in der API SP-Dokumentation unter Wie beantrage ich eine Rolle und qualifiziere mich dafür?.

Registrieren des Antrags

Der Registrierungsprozess variiert je nach Art der Anwendung geringfügig. Für die Zwecke der Registrierung werden Anträge in einen der folgenden Typen eingeteilt:

• Öffentliche Anwendungen und Anwendungen für Privatverkäufer — Dabei handelt es sich um Anwendungen, die öffentlich verfügbar sind und von einem Verkäufer oder Anbieter autorisiert wurden, oder es handelt sich um Verkäuferanwendungen, die nur für Ihr Unternehmen verfügbar sind und von Ihnen selbst autorisiert wurden.

• Anwendungen von privaten Anbietern — Dabei handelt es sich um Anwendungen von Anbietern, die nur für Ihr Unternehmen verfügbar sind und selbst autorisiert sind.

Weitere Informationen finden Sie in der API SP-Dokumentation unter Registrieren Sie Ihre Anwendung.

Wählen Sie ein Autorisierungsmodell für Ihre Anwendung

Das Autorisierungsmodell für den Verkaufspartner API basiert auf Login with Amazon, einer Amazon-Implementierung von OAuth 2.0. Ihre Bewerbung wird durch Interaktionen mit den von Amazon angezeigten Seiten und Ihrer Website autorisiert. Der Webbrowser ist der Benutzeragent, der bei jeder Aktion des Verkaufspartners Parameter zwischen Ihrer Website und Amazon weitergibt. Um die OAuth Autorisierung zu implementieren, müssen Sie Ihre Website so konfigurieren, dass sie die Parameter akzeptiert und verarbeitet, die Amazon an sie weitergibt. Sie müssen Ihre Website auch so konfigurieren, dass der Webbrowser umgeleitet und Parameter an Amazon übergeben werden. Weitere Informationen zur Autorisierung finden Sie in der API SP-Dokumentation unter Autorisierung von API Verkaufspartneranträgen.

Verstehen der Anwendungsautorisierung

Für die Autorisierung gibt es drei Arten von Anwendungen:

• Öffentliche Anwendungen für Verkäufer — Diese Anwendungen sind öffentlich verfügbar und wurden von Verkäufern autorisiert. Sie können eine der folgenden Autorisierungs-Optionen auswählen:

  • Autorisierungs-Workflow für Verkaufspartner im Appstore — Ein OAuth Autorisierungs-Workflow, der von der Detailseite des Verkaufspartner-Appstores aus initiiert wird.

  • Workflow zur Website-Autorisierung — Ein OAuth Autorisierungs-Workflow, der von Ihrer eigenen Website aus initiiert wird.

• Öffentliche Anwendungen für Anbieter — Diese Anwendungen sind öffentlich verfügbar und werden von Anbietern autorisiert. Sie können den Workflow zur Website-Autorisierung verwenden. Dies ist ein OAuth Autorisierungs-Workflow, der von Ihrer eigenen Website aus initiiert wird.

• Private Anwendungen für Verkäufer oder Anbieter — Diese Anwendungen stehen nur Ihrer Organisation zur Verfügung. Dabei kann es sich um Anwendungen von Verkäufern oder Anbietern handeln. Sie können den Selbstautorisierungsansatz verwenden. Wenn Sie eine private Anwendung für Ihre eigene Organisation erstellen, können Sie diese selbst autorisieren, auf Ihre Kontoinformationen zuzugreifen. Sie können Ihre Bewerbung im Entwurfsstatus selbst autorisieren. Es gibt keinen Grund, eine private Bewerbung zu veröffentlichen. Informationen zum Widerrufen der Selbstautorisierung in Verkäufern- und Lieferantenanträgen finden Sie in der SP-Dokumentation unter Widerrufen der Eigenautorisierung. API

Autorisieren Sie Anbietergruppen für den Anwendungszugriff

Wenn Sie Ihre API Verkaufspartner-Anwendung für den Zugriff auf Ihre Daten autorisieren, gewähren Sie Zugriff auf die Lieferantengruppe, die mit den Anmeldeinformationen für Ihr Vendor Central-Konto verknüpft ist. Im weiteren Sinne gewähren Sie Zugriff auf alle Lieferantencodes, die in der Lieferantengruppe vorhanden sind. Daher ist es wichtig, die richtigen Vendor Central-Anmeldeinformationen und die richtige Anbietergruppe für Ihre API Verkaufspartner-Integration zu verwenden.

Die Anbietergruppe ist das Konto, mit dem Sie sich anmelden. Abhängig von Ihren Geschäftsvereinbarungen, Betriebsmodellen und anderen Faktoren kann Ihre Lieferantengruppe einen oder mehrere Lieferantencodes enthalten. Jeder Lieferantencode ermöglicht es Ihnen, Produkte in einer bestimmten Kategorie anzubieten, oder er enthält die erforderlichen Geschäftsvereinbarungen, z. B. einen Lieferantencode für eine bestimmte Marke.

Sie können mehrere Autorisierungen für jede Lieferantengruppe haben, oder Sie können eine einzelne Lieferantengruppe erstellen, die alle Ihre Lieferantencodes enthält. Die Option, mehrere Lieferantengruppen zu verwenden, die Ihrem Profil zugeordnet sind, gibt Ihnen die Möglichkeit, eine Anwendung mit demselben Lieferantencode in verschiedenen Lieferantengruppen zu verwenden. Mit dieser Option müssen Sie nicht mehrere Entwickleranträge für jede Anbietergruppe einreichen.

Weitere Informationen finden Sie in der API SP-Dokumentation unter Autorisieren von Anbietergruppen für den Anwendungszugriff.

Connect zum SP- her API

Nachdem Sie Ihre Anwendung registriert und autorisiert haben, können Sie damit beginnen, Anfragen zu stellen. Weitere Informationen finden Sie API in der API SP-Dokumentation unter Verbindung zum Vertriebspartner herstellen.