PREREQUISITO: URL DI RICHIAMATA DEL RISULTATO DELLA QUERY PER WEBHOOK
Amzpecty richiede l'URL di richiamata per le notifiche API push dei dati webhook. Consentono alla tua app di conoscere i risultati della query (incluso il payload dei dati). L'URL di richiamata deve essere accessibile a livello globale, utilizzando il protocollo https POST e con un certificato SSL valido. Amzpecty potrebbe non essere in grado di inviare correttamente i webhook ai certificati SSL autofirmati.
In Java, puoi utilizzare HttpServlet con il metodo doPost per ricevere il payload dei dati Amzpecty. In altri linguaggi di programmazione, puoi implementare la stessa soluzione equivalente. Puoi implementare il tuo ascoltatore webhook utilizzando qualsiasi linguaggio di programmazione che supporti il protocollo HTTPS Post.
Assicurati che l'URL di richiamata sia pronto e inserito nel file Dashboard di Amzpecty https://api.amzpecty.com/preferences. Dopo che Amzpecty ha terminato la ricerca dei dati, Amzpecty pubblicherà HTTPS su questo URL i dati dei risultati in formato JSON. Quando l'intestazione AMZPECTY_CALLBACK_URL viene aggiunta alla chiamata di richiesta, avrà la precedenza sulle impostazioni dell'URL di richiamata delle preferenze.
Un'intestazione http denominata AMZPECTY-API-SECRET-KEY verrà inclusa nel post https per consentire al listener del webhook di convalidare l'origine della richiesta.
PASSI E PROCEDURA
- Effettua una chiamata Aggiungi [ Aggiungi Asin/ISBN alla coda di query dell'istantanea Asin ] o [ Aggiungi Asin principale alla coda di query delle varianti prodotto ] o [ Abbina l'ID prodotto alla coda di query ASIN ] ecc. per inserire la richiesta nella coda delle query.
- Il server API Amzpecty effettuerà una chiamata al tuo URL di richiamata per inviare i risultati non appena la ricerca sarà completata.
- La tua applicazione potrebbe utilizzare il rid dalla risposta alla chiamata Aggiungi per abbinare la richiamata alla tua richiesta originale.
Nota: Per le chiamate non correlate a varianti, assicurati che l'ASIN non sia un ASIN parent o un ASIN fuori produzione.
Non è necessario effettuare la query Get facoltativa a meno che non sia trascorso un tempo considerevole e non venga ricevuta alcuna richiamata. Si prega di astenersi dall'effettuare successive chiamate di aggiunta dello stesso ASIN.
OVERRIDE AGENTE UTENTE
I client possono sovrascrivere l'intestazione User-Agent predefinita per un'intestazione specifica specificando la chiave e il valore AMZPECTY-USER-AGENT durante una chiamata Add.
L'API Amzpecty imposterà il valore User-Agent durante le chiamate post-back.
CODIFICA
- La codifica dei dati di richiesta/risposta deve essere UTF-8
FINE
Contatta l'assistenza per URL personalizzati per server esclusivi o personalizzati.
SICUREZZA
- Tutte le connessioni di scambio dati tra Amzpecty e i peer devono avvenire tramite HTTPS (SSL/TLS) con un certificato SSL valido
- Amzpecty emetterà una chiave segreta per l'autenticazione della richiesta (il nome del parametro è secretKey): la chiave segreta può essere trovata nella pagina Preferenze > Amzpect API > La tua chiave segreta API.
TEMPO DI RISPOSTA ALLA DOMANDA
Sebbene facciamo del nostro meglio per elaborare tutte le richieste di query in modo tempestivo, non garantiamo la tempestività della richiamata del risultato. Ti preghiamo di considerare i ritardi di risposta nell'implementazione.
RICHIESTA ACCELERATORE
Assicurati che le tue richieste siano impostate ad intervalli di almeno 1-2 secondi per evitare chiamate API rifiutate. Effettuiamo controlli per evitare richieste di burst eccessive. Contatta l'assistenza per le eccezioni sui server personalizzati.
DETRAZIONI SUL CREDITO
Il credito viene detratto solo in caso di recupero riuscito dei dati. Ricevi chiamate come Ricevi tramite RID non detrarrà alcun credito.
