1. INÍCIO
  2. Docs
  3. Documentação Amzpecty
  4. Especificações da API Amzpecty
  5. API de instantâneo ASIN

API de instantâneo ASIN

ADICIONAR ASIN/ISBN À FILA DE CONSULTA ASIN SNAPSHOT

A solicitação para adicionar um ASIN/ISBN à fila de consulta do Asin Snapshot.

DEDUÇÃO DE CRÉDITO

1 (um) crédito deduzido após recuperação bem-sucedida dos dados.

PEDIDO
URI /api/query/add/{ASIN/ISBN}?domain={domain}&secretKey={secretKey}&condition={condition} {ASIN/ISBN} – obrigatório – o ASIN ou ISBN a ser adicionado à lista de rastreamento {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
{doença} – opcional – o padrão é novo se nulo/não especificado
valores válidos [novo, usado, colecionável, recondicionado, todos]
{excluirmoq} – opcional – o padrão é falso se for nulo/não especificado. valores válidos [verdadeiro, falso]. Se for verdade, Amzpecty excluirá a pesquisa moq.
Cabeçalho HTTP (opcional) AMZPECTY_CALLBACK_URL={Seu URL de retorno}
Exemplo /api/query/add/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx &condition=used&excludemoq=false
RESPOSTA
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "allowed": 4971,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "58eb4fb8bfc2333894ce7dc7",
    "dateProcessed": null
}

Note: Durante o retorno de chamada, o rid pode ser usado para vincular os dados de retorno de chamada à chamada de solicitação original.

RETORNO DE CHAMADA DE CONSULTA DE INSTANTÂNEO ASIN

PEDIDO DE RETORNO DE CONSULTA DE INSTANTÂNEO ASIN
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
ASIN SNAPSHOT CONSULTA CALLBACK JSON DE AMOSTRA DE DADOS
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "responsefor": "asinsnapshot",
    "allowed": 4992,
    "dailyAllowed": 500,
    "messageId": null,
    "message": null,
    "data": {
        "queryAsin": "B01MYEYYYY",
        "asin": "B01MYEYYEE",
        "itemName": "Nest 9750016 T3016US Thermostat Black",
        "brand": "by Nest",
        "salesRank": 11346,
        "totalQty": 150,
        "buyboxPrice": "237.15",
        "buyboxSellerName": "JJJ SELLER",
        "buyboxSellerId": "AAW8R82WBLFL9",
        "buyboxItemCondition": "New",
        "totalFBA": 6,
        "totalFBM": 7,
        "maxPrice": 599,
        "minPrice": 237.79,
        "avgPrice": 293.05,
        "isAmazonSelling": false,
        "isAmazonWarehouseSelling": false,
        "customerStarRating": "4.5 out of 5 stars",
        "customerReview": "5,006 ratings",
        "totalOffers": 1,
        "pageNotFound": false,
        "hasVariations": true,
        "unavailable": false,
        "offers": [
            {
                "sellerName": "cables4computer",
                "condition": "New",
                "price": 237.79,
                "priceShipping": 0,
                "priceTotal": 237.79,
                "fba": false,
                "inventoryCount": 11,
                "conditionNote": "",
                "ratingStar": 4.5,
                "sellerRating": "89% positive over the past 12 months. (13,223 total ratings)",
                "prime": false,
                "sellerId": "A3VZC5G7U3OWU4",
                "offerId": "8pwpOXydEI1znRNLYpU",
                "moq": false,
                "moqvalue": 0
            }
        ]
    },
    "rid": "5d6e0b63e4b0e29d7d7d232c",
    "dateProcessed": 1567492992552,
    "domain": "www.amazon.com",
    "totalCreditsDeducted": 1
}
ASIN SNAPSHOT CONSULTA CALLBACK RESPOSTA ATRIBUTOS JSON
Nome do AtributoAdicionar ao carrinho
estadoO status da solicitação.
resposta paraValor “sellerinfo” para o resultado da consulta de informações do vendedor.
permitidasA contagem atual de solicitações permitidas. Reinicia mensalmente.
diariamentePermitidoA contagem de solicitações diárias permitidas atualmente. Reinicia diariamente.
mensagemIdO ID da mensagem (se houver).
mensagemA mensagem real (se houver). Consulte Mensagens de erro.
livrarO ID da solicitação. Isso pode ser usado na consulta Get como uma chave.
domínioO domínio Amazon correspondente para o Vendedor.
totalCréditosDeduzidosEste campo indica quantos créditos da API Amzpecty foram usados ​​para atender esta solicitação.
dataProcessadoA data em que a solicitação foi processada no formato de hora unix.
dados.queryAsinO ASIN especificado na chamada ADD.
dados.asinO ASIN do produto. O ASIN pode ser diferente do ASIN especificado na chamada ADD.
Por exemplo, no caso de ASIN mesclado ou ASIN excluído.
dados. nome do itemO nome do item do produto.
dados. marcaA marca do produto.
dados. classificação de vendasO preço máximo de todas as ofertas deste produto.
dados. Quantidade totalA quantidade total estimada do produto.
dados. comprarboxPreçoO preço atual da caixa de compra do produto, excluindo frete.
dados. buyboxSellerNameO nome atual do vendedor do buybox do produto.
dados. buyboxSellerIdO ID do vendedor do buybox.
dados. buyboxItemCondiçãoA condição do item da caixa de compra.
dados. totalFBAO número total de vendedores FBA.
dados. totalFBMO número total de vendedores FBM.
dados. preço máximoO preço máximo de todas as ofertas deste produto.
dados. preço mínimoO preço mínimo de todas as ofertas deste produto.
dados. preço médioO preço médio de todas as ofertas deste produto.
dados. isAmazonVendendoSinalizador de conveniência se a Amazon tiver uma oferta para este item.
dados. isAmazonWarehouseVendaSinalizador de conveniência se o Amazon Warehouse tiver uma oferta para este item.
dados. clienteStarRatingAvaliação por estrelas do cliente. Valor de amostra “4.5 de 5 estrelas”
dados. avaliação do clienteContagem de avaliações do cliente. Valor de amostra “5,006 avaliações”
dados. ofertas totaisO número total de ofertas deste produto.
dados.indisponíveisSe for verdade, este sinalizador indica que não há oferta para este produto listado.
data.hasVariaçõesSe for verdade, este sinalizador indica que existem outras variações deste produto.
dados.pageNotFoundSe for verdade, este sinalizador indica que o ASIN não está listado no momento.
dados.imageUrlO URL da imagem do produto.
dados. ofertas[]A lista de ofertas do produto.
ofertas[n]. Nome do VendedorO nome do vendedor que oferece o produto.
ofertas[n]. ID do vendedorO ID do vendedor desta oferta.
ofertas[n]. doençaA condição do produto.
ofertas[n]. preçoO preço do produto.
ofertas[n]. preçoFreteA taxa de envio desta oferta de produto.
ofertas[n]. preçoTotalA soma do preço e frete desta oferta de produto.
ofertas[n]. fbaÉ oferecer bandeira FBA.
ofertas[n]. contagem de inventárioA quantidade disponível oferecida pelo vendedor deste produto.
ofertas[n]. condiçãoNotaA nota sobre o estado do produto. (Caso existam)
ofertas[n]. avaliaçãoEstrelaA classificação por estrelas deste vendedor que oferece o produto.
ofertas[n]. Avaliação do vendedorA avaliação deste vendedor que oferece o produto.
ofertas[n]. melhorA bandeira que indica se esta oferta é elegível para prime.
ofertas[n]. ID do vendedorO ID do vendedor desta oferta.
ofertas[n]. ID da ofertaO ID desta oferta
ofertas[n]. quantidade mínimaO sinalizador de quantidade mínima de pedido desta oferta. (Se o vendedor impor MOQ)
ofertas[n]. valor mínimoO valor real da quantidade mínima do pedido desta oferta. (Se o vendedor impor MOQ)

OBTER O RESULTADO DO INSTANTÂNEO ASIN POR ASIN/ISBN

A solicitação para obter o resultado mais recente do Asin Snapshot por ASIN/ISBN.

DEDUÇÃO DE CRÉDITO

0 (zero) dedução de crédito para a chamada Get.

PEDIDO
URI /api/query/get/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} {ASIN/ISBN} – o ASIN para obter a lista de rastreamento 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/get/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RESPOSTA

See Dados de amostra JSON de retorno de chamada de consulta de instantâneo Asin

OBTER O RESULTADO DO INSTANTÂNEO ASIN POR ID DE PEDIDO

A solicitação para obter o resultado mais recente do Asin Snapshot por ID de solicitação (livre).

DEDUÇÃO DE CRÉDITO

0 (zero) dedução de crédito para a chamada Get.

PEDIDO
URI {rid} – ID de solicitação da resposta /api/query/add/ {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
Exemplo /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RESPOSTA

See Dados de amostra JSON de retorno de chamada de consulta de instantâneo Asin

OBTER O RESULTADO DO INSTANTÂNEO ASIN POR ID DE PEDIDO

A solicitação para obter o resultado mais recente do Asin Snapshot por ID de solicitação (livre).

DEDUÇÃO DE CRÉDITO

0 (zero) dedução de crédito para a chamada Get.

PEDIDO
URI {rid} – ID de solicitação da resposta /api/query/add/ {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
Exemplo /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RESPOSTA

See Dados de amostra JSON de retorno de chamada de consulta de instantâneo Asin

Este artigo foi útil para você? Sim Não
Como podemos ajudar?