1. Casa
  2. Docs
  3. Documentazione di amzpecty
  4. Specifiche API Amzpecty
  5. API per le varianti del prodotto

API per le varianti del prodotto

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
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
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 attributoDettagli
statusLo stato della richiesta.
rispostaperValore "productvariations" per il risultato della query Variazioni prodotto
permessoConteggio delle richieste attualmente consentite. Si ripristina mensilmente.
giornalieroConsentitoIl conteggio attuale delle richieste giornaliere consentite. Si ripristina quotidianamente.
ID messaggioL'ID del messaggio (se presente).
messaggioIl messaggio effettivo (se presente). Si prega di fare riferimento a Messaggi di errore.
liberareL'ID della richiesta. Questo può essere utilizzato per abbinare questa risposta alla richiesta originale.
dataProcessedLa data in cui la richiesta è stata elaborata nel formato ora Unix.
dominioIl dominio Amazon di destinazione.
crediti totali detrattiQuesto campo indica quanti crediti API Amzpecty sono stati utilizzati per soddisfare questa richiesta.
data.parentAsinL'ASIN parent delle varianti del prodotto.
dati. Nome dell'elementoIl nome dell'articolo del prodotto.
dati. venditeRankLa classifica delle vendite del prodotto principale.
dati. opzioni[]L'elenco delle opzioni disponibili. Ad esempio ["Dimensione", "Colore"]
dati.totalVariationsIl numero totale di variazioni per l'Asin principale.
dati. varianti[]L'elenco delle varianti del Parent Asin.
dati.varianti[n].asinL'Asin di questa variante.
dati.varianti[n].productUrlL'URL del prodotto di questa variante.
dati.varianti[n].opzione1La chiave per questa prima opzione elencata in data.options[]. Ad esempio, "Dimensione"
dati.varianti[n].opzione1ValoreIl valore per questa prima opzione. Ad esempio "9"
dati.varianti[n].opzione2La chiave per questa seconda opzione elencata in data.options[]. Ad esempio, "Colore"
dati.varianti[n].opzione2ValoreIl 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*ValoreIl valore per questa ennesima opzione.
data.variants[n].BBSellerNameIl nome del venditore della Buybox di questa variante.
dati.varianti[n].BBPriceIl prezzo del buybox di questa variante esclusa la spedizione.
dati.varianti[n].BBQuantityLa quantità disponibile per il venditore Buybox di questa variante.
dati.varianti[n].BBTypeIl tipo di venditore di questa variante. “FBA” o “FBM”
data.variants[n].salesRankLa classifica delle vendite di questa variante.
data.variants[n].totalOffersIl numero di offerte di questa variante.
dati.varianti[n].dimensioneLa dimensione di questa variante.
dati.varianti[n].imageUrlL'URL dell'immagine di questa variante.
dati.varianti[n].pesoIl peso di questa variante.
data.variants[n].reviewPercentageQuesta variante è (numero di recensioni/numero di tutte le recensioni) X 100.
data.variants[n].reviewCountDEPRECATO dall'11 settembre 2020. Utilizza invece globalReviewPositive e globalReviewCritical.
data.variants[n].globalRatingsPositiveNUOVO. Aggiunto l'11 settembre 2020. Il totale delle valutazioni positive globali conta per questa variante.
data.variants[n].globalRatingsCriticalNUOVO. Aggiunto l'11 settembre 2020. Conteggio delle valutazioni critiche globali totali di questa variante.
data.variants[n].globalReviewPositiveNUOVO. Aggiunto l'11 settembre 2020. Conteggio totale delle recensioni positive globali di questa variante.
data.variants[n].globalReviewCriticalNUOVO. Aggiunto l'11 settembre 2020. Conteggio totale delle revisioni critiche globali di questa variante.
data.variants[n].recentReviewLa data di revisione più recente di questa variante.
data.variants[n].searchStatusLo 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

È stato utile quest'articolo? Non
Come vi possiamo aiutare?