ADICIONAR ASIN PAI À FILA DE CONSULTA DE VARIAÇÕES DO PRODUTO
A solicitação para adicionar um ASIN pai à fila de consulta de variações do produto.
DEDUÇÃO DE CRÉDITO
1 (um) crédito de dedução para cada variante após recuperação bem-sucedida dos dados. Exemplo: Se houver 5 variantes, serão deduzidos 5 (cinco) créditos se todas as informações das 5 variantes forem recuperadas com sucesso.
PEDIDO
| URI | /api/query/requestvariants/ {PARENTASIN}?domain={domain}&secretKey={secretKey} | {PARENTASIN } – obrigatório – o ASIN pai a ser adicionado à fila de pesquisa de variantes {domain} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista. |
| Cabeçalho HTTP (opcional) | AMZPECTY_CALLBACK_URL={Seu URL de retorno} | |
| Exemplo | /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPOSTA
| Cabeçalhos | |
| Tipo de mídia | aplicação / json |
| Dados JSON |
JSON
{
"status": "OK",
"allowed": 999,
"dailyAllowed": 100,
"messageId": null,
"message": null,
"data": null,
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": null
}CONSULTA DE VARIAÇÕES DO PRODUTO
PEDIDO DE CONSULTA DE VARIAÇÕES DO PRODUTO
| URI | Exemplo: https://your.server.com/amzpecty_result | {Forneça o URL na página de preferências} O URL deve estar habilitado para SSL. AMZPECTY-API-SECRET-KEY (nome do cabeçalho) – o cabeçalho da chave secreta será incluído para o servidor de retorno de chamada validar a origem da solicitação |
| Tipo de mídia | aplicação / json |
VARIAÇÕES DO PRODUTO CONSULTA CALLBACK JSON DE AMOSTRA DE DADOS
| Cabeçalhos | |
| Tipo de mídia | aplicação / json |
| Dados 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
}VARIAÇÕES DO PRODUTO CONSULTA ATRIBUTOS JSON DE RESPOSTA DE CHAMADA
| Nome do Atributo | Adicionar ao carrinho |
|---|---|
| estado | O status da solicitação. |
| resposta para | Valor “productvariations” para o resultado da consulta de variações do produto |
| permitidas | A contagem atual de solicitações permitidas. Reinicia mensalmente. |
| diariamentePermitido | A contagem de solicitações diárias permitidas atualmente. Reinicia diariamente. |
| mensagemId | O id da mensagem (se houver). |
| mensagem | A mensagem real (se houver). Por favor consulte Mensagens de erro. |
| livrar | O ID da solicitação. Isso pode ser usado para combinar esta resposta com a solicitação original. |
| dataProcessado | A data em que a solicitação foi processada no formato de hora unix. |
| domínio | O domínio Amazon de destino. |
| totalCréditosDeduzidos | Este campo indica quantos créditos da API Amzpecty foram usados para atender esta solicitação. |
| dados.parentAsin | O ASIN pai das variantes do produto. |
| dados. nome do item | O nome do item do produto. |
| dados. classificação de vendas | A classificação de vendas do produto pai. |
| dados. opções[] | A lista de opções disponíveis. Por exemplo [“Tamanho”, “Cor”] |
| dados.totalVariações | O número total de variações do Asin Pai. |
| dados. variantes[] | A lista de variantes do Parent Asin. |
| dados.variantes[n].asin | O Asin desta variante. |
| dados.variants[n].productUrl | O URL do produto desta variante. |
| dados.variantes[n].opção1 | A chave para esta primeira opção conforme listada em data.options[]. Por exemplo, “Tamanho” |
| dados.variants[n].option1Value | O valor para esta primeira opção. Por exemplo, “9” |
| dados.variantes[n].opção2 | A chave para esta segunda opção conforme listada em data.options[]. Por exemplo, “Cor” |
| dados.variants[n].option2Value | O valor para esta segunda opção. Por exemplo, “Yellowstone Amarelo” |
| dados.variants[n].option* | A chave para esta enésima opção listada em data.options[]. |
| data.variants[n].option*Valor | O valor para esta enésima opção. |
| data.variants[n].BBSellerName | O nome do vendedor da buybox desta variante. |
| dados.variants[n].BBPrice | O preço buybox desta variante, excluindo frete. |
| dados.variants[n].BBQuantity | A quantidade disponível para o vendedor buybox desta variante. |
| dados.variants[n].BBType | O tipo de vendedor desta variante. “FBA” ou “FBM” |
| data.variants[n].salesRank | A classificação de vendas desta variante. |
| data.variants[n].totalOffers | O número de ofertas desta variante. |
| dados.variants[n].dimension | A dimensão desta variante. |
| dados.variants[n].imageUrl | O URL da imagem desta variante. |
| dados.variantes[n].peso | O peso desta variante. |
| data.variants[n].reviewPercentage | Esta variante (contagem de revisões/contagem de todas as revisões) X 100. |
| DEPRECADO em 11 de setembro de 2020. Em vez disso, use globalReviewPositive e globalReviewCritical. | |
| data.variants[n].globalRatingsPositivo | NOVO. Adicionado em 11 de setembro de 2020. O total de classificações positivas globais conta para esta variante. |
| data.variants[n].globalRatingsCritical | NOVO. Adicionado em 11 de setembro de 2020. A contagem total de classificações críticas globais desta variante. |
| data.variants[n].globalReviewPositive | NOVO. Adicionado em 11 de setembro de 2020. A contagem global total de análises positivas desta variante. |
| data.variants[n].globalReviewCritical | NOVO. Adicionado em 11 de setembro de 2020. A contagem global total de análises críticas desta variante. |
| data.variants[n].recentReview | A data de revisão mais recente desta variante. |
| dados.variants[n].searchStatus | O status da consulta desta variante. “em andamento” ou “concluído” |
OBTER DADOS DE RESULTADO DE CONSULTA DE VARIAÇÕES DO PRODUTO PELO PAI ASIN
0 (zero) dedução de crédito para a chamada Get.
A solicitação para obter os dados do resultado da consulta de variações do produto por ASIN pai.
PEDIDO
| URI | /api/query/getmatchasins/rid/{rid}?domain={domain}&secretKey={secretKey} | { PARENTASIN } – o ASIN pai para obter a lista de variantes mais recente {domain} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista. |
| Exemplo | /api/query/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPOSTA
See Variações do produto consultam dados de amostra JSON de retorno de chamada
OBTER VARIAÇÕES DO PRODUTO SOLICITAR DADOS DE RESULTADO POR ID DE SOLICITAÇÃO
A solicitação para obter os dados do resultado da consulta de variações do produto por ID da solicitação.
DEDUÇÃO DE CRÉDITO
0 (zero) dedução de crédito para a chamada Get.
PEDIDO
| URI | /api/query/getvariants/rid/{ RID }?domain={domain}&secretKey={secretKey} | { RID } – o ID da solicitação para obter a lista de variantes mais recente {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista. |
| Exemplo | /api/query/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPOSTA
See Variações do produto consultam dados de amostra JSON de retorno de chamada
