VORAUSSETZUNG: CALLBACK-URL DES ABFRAGERESULTATS FÜR WEBHOOKS
Amzpecty erfordert eine Rückruf-URL für Webhook-Daten-Push-API-Benachrichtigungen. Sie teilen Ihrer App die Abfrageergebnisse (einschließlich Datennutzlast) mit. Die Rückruf-URL muss global zugänglich sein, das https-POST-Protokoll verwenden und über ein gültiges SSL-Zertifikat verfügen. Amzpecty ist möglicherweise nicht in der Lage, Webhooks erfolgreich an selbstsignierte SSL-Zertifikate zu senden.
In Java können Sie HttpServlet mit der doPost-Methode verwenden, um die Amzpecty-Datennutzlast zu empfangen. In anderen Programmiersprachen können Sie möglicherweise dieselbe äquivalente Lösung implementieren. Sie können Ihren Webhook-Listener mit jeder Programmiersprache implementieren, die das HTTPS-Post-Protokoll unterstützt.
Bitte stellen Sie sicher, dass Ihre Rückruf-URL bereitsteht und im eingegeben wird Amzpecty-Dashboard https://api.amzpecty.com/preferences. Nachdem Amzpecty mit der Datensuche fertig ist, sendet Amzpecty per HTTPS die JSON-formatierten Ergebnisdaten an diese URL. Wenn der Header AMZPECTY_CALLBACK_URL zum Anforderungsaufruf hinzugefügt wird, hat er Vorrang vor den Einstellungen für die Rückruf-URL in den Einstellungen.
Ein http-Header mit dem Namen AMZPECTY-API-SECRET-KEY wird in den https-Beitrag eingefügt, damit der Webhook-Listener den Ursprung der Anfrage validieren kann.
SCHRITTE UND VERFAHREN
- Einen Anruf hinzufügen [ Fügen Sie Asin/ISBN zur Asin-Snapshot-Abfragewarteschlange hinzu ] oder [Übergeordnete Asin zur Produktvariations-Abfragewarteschlange hinzufügen] oder [ Ordnen Sie die Produkt-ID der ASIN-Abfragewarteschlange zu ] usw., um Ihre Anfrage in die Abfragewarteschlange zu stellen.
- Der Amzpecty-API-Server ruft Ihre Rückruf-URL auf, um die Ergebnisse zu senden, sobald die Suche abgeschlossen ist.
- Ihre Anwendung verwendet möglicherweise das RID aus der Anrufantwort hinzufügen, um den Rückruf Ihrer ursprünglichen Anfrage zuzuordnen.
Hinweis: Stellen Sie bei Anrufen ohne Variantenbezug bitte sicher, dass es sich bei der ASIN nicht um eine übergeordnete ASIN oder eine abgekündigte ASIN handelt.
Sie müssen die optionale Get-Abfrage nicht durchführen, es sei denn, es ist viel Zeit vergangen und es wird kein Rückruf empfangen. Bitte sehen Sie davon ab, aufeinanderfolgende Add-Aufrufe derselben ASIN durchzuführen.
BENUTZER-AGENTEN-OVERRIDE
Clients können den standardmäßigen User-Agent-Header für einen bestimmten Header überschreiben, indem sie während eines Add-Aufrufs den AMZPECTY-USER-AGENT-Schlüssel und -Wert angeben.
Die Amzpecty-API legt den User-Agent-Wert bei Postback-Aufrufen fest.
CODIERUNG
- Die Codierung der Anforderungs-/Antwortdaten sollte UTF-8 sein
ENDPUNKT
Kontaktieren Sie den Support für benutzerdefinierte URLs für exklusive oder benutzerdefinierte Server.
SICHERHEIT
- Alle Datenaustauschverbindungen zwischen Amzpecty und Peers müssen über HTTPS (SSL/TLS) mit einem gültigen SSL-Zertifikat erfolgen
- Amzpecty stellt einen geheimen Schlüssel für die Anforderungsauthentifizierung aus (Parametername lautet „secretKey“) – Den geheimen Schlüssel finden Sie auf der Seite „Einstellungen“ > „Amzpect API“ > „Ihr geheimer API-Schlüssel“.
ANTWORTZEIT AUF FRAGE
Obwohl wir unser Bestes tun, um alle Anfragen zeitnah zu bearbeiten, Für die Aktualität des Ergebnisrückrufs übernehmen wir keine Gewähr. Bitte berücksichtigen Sie Reaktionsverzögerungen bei Ihrer Implementierung.
GASANFRAGE
Bitte stellen Sie sicher, dass Ihre Anfragen in Abständen von mindestens 1–2 Sekunden eingestellt werden, um abgelehnte API-Aufrufe zu vermeiden. Wir verfügen über Kontrollen, um übermäßige Burst-Anfragen zu vermeiden. Bitte kontaktieren Sie den Support für Ausnahmen auf benutzerdefinierten Servern.
KREDITABZÜGE
Der Guthabenabzug erfolgt erst bei erfolgreichem Datenabruf. Bei Get-Aufrufen wie „Get by RID“ wird kein Guthaben abgezogen.
