AGGIUNGI L'ASIN PRINCIPALE ALLA CODA DI QUERY DELLE VARIAZIONI DEL PRODOTTO
La richiesta di aggiungere un ASIN parent alla coda di query delle varianti prodotto.
DETRAZIONE DEL CREDITO
1 (uno) detrazione di credito per ciascuna variante dopo il riuscito recupero dei dati. Esempio: se sono presenti 5 varianti, verranno detratti 5 (cinque) crediti se tutte le informazioni sulle 5 varianti vengono recuperate con successo.
RICHIESTA
URI | /api/query/requestvariants/ {PARENTASIN}?domain={dominio}&secretKey={secretKey} | {PARENTASIN } – obbligatorio – l'ASIN parent da aggiungere alla coda di ricerca delle varianti {dominio} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista. |
Intestazione HTTP (facoltativa) | AMZPECTY_CALLBACK_URL={Il tuo URL di richiamata} | |
Esempio | /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx |
RISPOSTA
Headers | |
Tipo di supporto | application / json |
Dati JSON |
{
"status": "OK",
"allowed": 999,
"dailyAllowed": 100,
"messageId": null,
"message": null,
"data": null,
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": null
}
VARIAZIONI DEL PRODOTTO QUERY CALLBACK
VARIAZIONI PRODOTTO QUERY RICHIESTA DI RICHIAMATA
URI | Esempio: https://your.server.com/amzpecty_result | {Fornire l'URL nella pagina Preferenze} L'URL deve essere abilitato per SSL. AMZPECTY-API-SECRET-KEY (nome intestazione): l'intestazione della chiave segreta verrà inclusa per il server di richiamata per convalidare l'origine della richiesta |
Tipo di supporto | application / json |
VARIAZIONI DEL PRODOTTO QUERY CALLBACK DATI DI ESEMPIO JSON
Headers | |
Tipo di supporto | application / json |
Dati JSON |
{
"status": "OK",
"responsefor": "productvariations",
"allowed": 142658,
"dailyAllowed": 9828,
"messageId": null,
"message": null,
"data": {
"parentAsin": "B077HN95T8",
"itemName": "Pendleton Women’s Heritage Chelsea Slip-Resistant Rain Boot",
"salesRank": 31070,
"options": [
"Size",
"Color"
],
"totalVariations": 86,
"variants": [
{
"asin": "B0772WW76G",
"productUrl": "https://www.amazon.com/dp/B0772WW76G?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Rainier Red",
"BBSellerName": "Fishbone Apparel",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "3.8 x 9.5 x 11.7 inches",
"imageUrl": "https://m.media-amazon.com/images/I/31wd4kuv6IL._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.351 pounds",
"reviewPercentage": 2.08,
"reviewCount": 2,
"globalRatingsPositive": 4486,
"globalRatingsCritical": 421,
"globalReviewPositive": 1286,
"globalReviewCritical": 271,
"recentReview": "March 7, 2020",
"searchStatus": "completed"
},
{
"asin": "B07PJT8S6K",
"productUrl": "https://www.amazon.com/dp/B07PJT8S6K?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Starwatchers Blue Print",
"BBSellerName": "new pairs",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "4.25 x 10.87 x 13.07 inches",
"imageUrl": "https://m.media-amazon.com/images/I/41ooAxDOy5L._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.4502 pounds",
"reviewPercentage": 0,
"reviewCount": 0,
"globalRatingsPositive": 0,
"globalRatingsCritical": 0,
"globalReviewPositive": 0,
"globalReviewCritical": 0,
"recentReview": "",
"searchStatus": "completed"
}
]
},
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": 1584429103564,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}
VARIAZIONI DEL PRODOTTO QUERY CALLBACK RISPOSTA ATTRIBUTI JSON
nome attributo | Dettagli |
---|---|
status | Lo stato della richiesta. |
rispostaper | Valore "productvariations" per il risultato della query Variazioni prodotto |
permesso | Conteggio delle richieste attualmente consentite. Si ripristina mensilmente. |
giornalieroConsentito | Il conteggio attuale delle richieste giornaliere consentite. Si ripristina quotidianamente. |
ID messaggio | L'ID del messaggio (se presente). |
messaggio | Il messaggio effettivo (se presente). Si prega di fare riferimento a Messaggi di errore. |
liberare | L'ID della richiesta. Questo può essere utilizzato per abbinare questa risposta alla richiesta originale. |
dataProcessed | La data in cui la richiesta è stata elaborata nel formato ora Unix. |
dominio | Il dominio Amazon di destinazione. |
crediti totali detratti | Questo campo indica quanti crediti API Amzpecty sono stati utilizzati per soddisfare questa richiesta. |
data.parentAsin | L'ASIN parent delle varianti del prodotto. |
dati. Nome dell'elemento | Il nome dell'articolo del prodotto. |
dati. venditeRank | La classifica delle vendite del prodotto principale. |
dati. opzioni[] | L'elenco delle opzioni disponibili. Ad esempio ["Dimensione", "Colore"] |
dati.totalVariations | Il numero totale di variazioni per l'Asin principale. |
dati. varianti[] | L'elenco delle varianti del Parent Asin. |
dati.varianti[n].asin | L'Asin di questa variante. |
dati.varianti[n].productUrl | L'URL del prodotto di questa variante. |
dati.varianti[n].opzione1 | La chiave per questa prima opzione elencata in data.options[]. Ad esempio, "Dimensione" |
dati.varianti[n].opzione1Valore | Il valore per questa prima opzione. Ad esempio "9" |
dati.varianti[n].opzione2 | La chiave per questa seconda opzione elencata in data.options[]. Ad esempio, "Colore" |
dati.varianti[n].opzione2Valore | Il valore per questa seconda opzione. Ad esempio "Yellowstone Giallo" |
dati.varianti[n].opzione* | La chiave per questa ennesima opzione elencata in data.options[]. |
dati.variants[n].opzione*Valore | Il valore per questa ennesima opzione. |
data.variants[n].BBSellerName | Il nome del venditore della Buybox di questa variante. |
dati.varianti[n].BBPrice | Il prezzo del buybox di questa variante esclusa la spedizione. |
dati.varianti[n].BBQuantity | La quantità disponibile per il venditore Buybox di questa variante. |
dati.varianti[n].BBType | Il tipo di venditore di questa variante. “FBA” o “FBM” |
data.variants[n].salesRank | La classifica delle vendite di questa variante. |
data.variants[n].totalOffers | Il numero di offerte di questa variante. |
dati.varianti[n].dimensione | La dimensione di questa variante. |
dati.varianti[n].imageUrl | L'URL dell'immagine di questa variante. |
dati.varianti[n].peso | Il peso di questa variante. |
data.variants[n].reviewPercentage | Questa variante è (numero di recensioni/numero di tutte le recensioni) X 100. |
DEPRECATO dall'11 settembre 2020. Utilizza invece globalReviewPositive e globalReviewCritical. | |
data.variants[n].globalRatingsPositive | NUOVO. Aggiunto l'11 settembre 2020. Il totale delle valutazioni positive globali conta per questa variante. |
data.variants[n].globalRatingsCritical | NUOVO. Aggiunto l'11 settembre 2020. Conteggio delle valutazioni critiche globali totali di questa variante. |
data.variants[n].globalReviewPositive | NUOVO. Aggiunto l'11 settembre 2020. Conteggio totale delle recensioni positive globali di questa variante. |
data.variants[n].globalReviewCritical | NUOVO. Aggiunto l'11 settembre 2020. Conteggio totale delle revisioni critiche globali di questa variante. |
data.variants[n].recentReview | La data di revisione più recente di questa variante. |
data.variants[n].searchStatus | Lo stato della query di questa variante. “in corso” o “completato” |
OTTIENI I DATI DEI RISULTATI DELLA RICERCA DELLE VARIAZIONI DEL PRODOTTO DALL'ASIN GENITORE
Detrazione di 0 (zero) credito per la chiamata Get.
La richiesta di ottenere i dati dei risultati della query sulle varianti del prodotto da parte dell'ASIN parent.
RICHIESTA
URI | /api/query/getmatchasins/rid/{rid}?domain={dominio}&secretKey={secretKey} | {PARENTASIN} – l'ASIN principale per ottenere l'elenco delle varianti più recenti. {dominio} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista. |
Esempio | /api/query/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx |
RISPOSTA
See Variazioni del prodotto Query dati di esempio JSON di richiamata
OTTIENI VARIAZIONI PRODOTTO RICHIEDI DATI RISULTATO PER ID RICHIESTA
La richiesta per ottenere le varianti del prodotto interroga i dati dei risultati in base all'ID richiesta.
DETRAZIONE DEL CREDITO
Detrazione di 0 (zero) credito per la chiamata Get.
RICHIESTA
URI | /api/query/getvariants/rid/{ RID }?domain={dominio}&secretKey={secretKey} | { RID } – l'ID richiesta per ottenere l'elenco delle varianti più recenti {dominio} – facoltativo – il valore predefinito è www.amazon.com se non specificato. Vedere Domini Amazon supportati per lista. |
Esempio | /api/query/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx |
RISPOSTA
See Variazioni del prodotto Query dati di esempio JSON di richiamata