Dokumentation
Entwickler-HubAPI-StatusUnterstützung

Aufbau robuster Amazon SP-API-Anwendungen

Erstellen Sie robuste Vertriebspartner-API-Anwendungen.

Ihre SP-API-Clientanwendungen sollten Änderungen an Berichten und Antwortelementen, die SP-API zurückgibt, auch ohne vorherige Benachrichtigung von Amazon verarbeiten.

Änderungen an Berichten, die von der SP-API zurückgegeben wurden

Integrieren Sie in Ihren Client-Anwendungen Berichts-Parser, die die folgenden Arten von Änderungen an den Berichten, die SP-API zurückgibt, verarbeiten können:

  • Neue Felder in Berichten. Ihre Clientanwendungen sollten neue Felder in Berichten verarbeiten, sobald sie verfügbar sind. Dazu gehören neue Spalten in Textdatei-Berichten und neue Elemente in XML-Berichten.
  • Neue Feldwerte in Berichten. Ihre Clientanwendungen sollten neue Feldwerte in Berichten verarbeiten, sobald sie verfügbar sind. Dazu gehören neue Spaltenwerte in Textdatei-Berichten und neue Elementwerte in XML-Berichten.

📘

Integrierte Fehlerbehandlung, wenn Sie Berichts-XSDs verwenden

Wenn Sie sich dafür entscheiden, von Amazon veröffentlichte Berichts-XSDs zur Validierung von Berichten zu verwenden, die von der SP-API zurückgegeben wurden, sollten Sie die Fehlerbehandlung in Ihre Validierungslogik integrieren. Jede in Ihrer Clientanwendung enthaltene Berichtsvalidierung sollte in der Lage sein, neue, unbekannte Antwortelemente oder Antwortelementwerte zu verarbeiten.

Änderungen an SP-API-Antwortelementen

Erstellen Sie Ihre Clientanwendungen so, dass sie die folgenden Arten von Änderungen an SP-API-Antworten ordnungsgemäß verarbeiten:

  • Neue Antwortelemente. Ihre Clientanwendungen sollten neue, unbekannte Antwortelemente verarbeiten.
  • Neue Werte für das Antwortelement. Ihre Clientanwendungen sollten neue, unbekannte Werte von Antwortelementen verarbeiten.

Bewährte Verfahren

  • Erwarten Sie Änderungen. Stellen Sie sicher, dass Ihre Clientanwendungen nicht zusammenbrechen, wenn neue Antwortelemente, Antwortelementwerte, Berichtsfelder oder Berichtsfeldwerte von Amazon eingeführt werden. Programmieren Sie Ihre Clientanwendungen nicht so, dass sie nur bestimmte Elemente, Felder oder Werte erwarten.
  • Protokollieren Sie nicht erkannte Elemente, Felder oder Werte. Führen Sie ein Protokoll über alle nicht erkannten Elemente, Felder oder Werte, die von der SP-API zurückgegeben werden. Anhand dieses Protokolls können Sie neue Funktionen, die von Amazon eingeführt wurden, kennzeichnen und dann Ihre Clientanwendung aktualisieren, um die Vorteile dieser Funktionen zu nutzen.
  • Zeigen Sie nicht erkannte Elemente, Felder oder Werte an. Wenn SP-API beispielsweise einen Bericht mit einem neuen Feld zurückgibt, können Sie einen Weg finden, die neuen Feldwerte in Ihrer Clientanwendung automatisch so anzuzeigen, dass sie für Ihre Benutzer nützlich sind.
  • Erwarten Sie Antwortelemente in beliebiger Reihenfolge. Antwortelemente können in beliebiger Reihenfolge innerhalb einer Struktur zurückgegeben werden. Stellen Sie sicher, dass Ihre Clientanwendungen nicht von der Bestellung abhängen, in der die Antwort-Elemente von SP-API zurückgegeben werden.
  • Verwenden Sie die neueste Modellversion. Um zu verhindern null Werte auflisten, verwenden Sie die neueste Version des API-Modells.

Hat Ihnen diese Seite weitergeholfen?