Home > API & Documentação > Detalhes técnicos de um produto

Detalhes técnicos de um produto

Nesta página:

Este serviço retorna os detalhes técnicos de um determinado produto.

Como funciona?

  1. Aplicação efetua uma requisição informando o ID do produto.
  2. Serviço recebe a requisição e busca os detalhes do produto no Buscapé.
  3. Serviço retorna a detalhes do produto no formato XML para aplicação.

Funcionamento dos detalhes técnicos do produto

Formatos de URL aceitos

http://sandbox.buscape.com/service/viewProductDetails/<application_id>/?productId=<productId>

Formatos de resposta

O formato padrão de resposta é XML.

Caso queira utilizar o formato de resposta JSON, adicione o parâmetro format=json.

Exemplo de requisição

http://sandbox.buscape.com/service/viewProductDetails/<application_id>/?productId=122312

XSD Document (XML SCHEMAS)

http://developer.buscape.com/xsd/buscape.xsd

Parâmetros

Parâmetros Tipo Descrição
productId Int ID do produto

Campos de resposta

Result

Campos Tipo Descrição
details ResultDetails Detalhes da requisição
category CategoryType Dados da categoria atual
totalResultsAvailable Int Total de itens disponíveis
totalResultsReturned Int Total de itens retornados
totalPages Int Total de páginas
page Int Número da página atual
match String Retorna o tipo de pesquisa por palavra(s)-chave(s)
  • all: Pesquisa perfeita, toda(s) palavra(s)-chave(s) encontrada(s)
  • any: Pesquisa parcial, alguma(s) palavra(s)-chave(s) encontrada(s)
  • none: Pesquisa não encontrada

ResultDetails

Campos Tipo Descrição
applicationID String ID da aplicação
date String Data/Hora da requisição com timezone
elapsedTime Long Tempo de execução da requisição em milisegundos
status String Status da resposta
code Int Código da resposta
message String Mensagem da resposta

CategoryType

Campos Tipo Descrição
id Int ID da categoria
parentCategoryId Int ID da categoria pai
isFinal Boolean TRUE caso seja uma categoria final
name String Nome da categoria
links LinksType Lista de links
  • category: URL da categoria no Buscapé
  • XML: URL do serviço de busca de ofertas ou produtos pelo ID da categoria
thumbnail ThumbnailType Imagem da categoria

ProductType

Campos Tipo Descrição
id Int ID do produto
categoryId Int ID da categoria
totalSellers Int Total de empresas com ofertas para este produto
productName String Nome do produto
priceMin String Preço Mínimo
priceMax String Preço Máximo
links LinkType Links do produto
  • XML: URL do serviço de busca de ofertas pelo ID do produto
  • product: URL do produto no Buscapé
  • specification: URL da especificação do produto no Buscapé
thumbnail ThumbnailType Imagem do produto
rating RatingType Avaliação do produto
specification SpecificationType Detalhes do produto

LinksType

Campos Tipo Descrição
link LinkType Link

LinkType

Campos Tipo Descrição
type String Tipo do Link:
url String Endereço do link

ThumbnailType

Campos Tipo Descrição
url String Endereço imagem

RatingType

Campos Tipo Descrição
userAverageRating UserRatingType Avaliação dos usuários

UserRatingType

Campos Tipo Descrição
numComments Int Número de comentários
rating String Média das notas dos usuários
link LinkType Link da avaliação
  • XML: URL do serviço de avalição dos usuário pelo ID do produto
specification SpecificationType Avaliação por itens do produto

ProductDetailsType

Campos Tipo Descrição
specification SpecificationType Lista de especificações técnicas do produto

SpecificationType

Campos Tipo Descrição
item ItemListType Lista de itens da especificação
links LinkType Links
label String Descrição da especificação

ItemListType

Campos Tipo Descrição
label String Nome do Item
value String Valor do item

Exemplo de resposta

Buscar detalhes do produto 122312.

http://sandbox.buscape.com/service/viewProductDetails/<application_id>/?productId=122312
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Result xmlns="urn:buscape" totalResultsReturned="0" totalResultsAvailable="0">
        <details>
            <applicationID><APPLICATION_ID></applicationID>
            <date>2008-08-17T18:11:42.018-03:00</date>
            <elapsedTime>131</elapsedTime>
            <status>success</status>
            <code>0</code>
            <message>success</message>
        </details>
        <category isFinal="true" parentCategoryId="2" id="36">
            <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/36.jpg"/>
            <links>
                <link type="category" url="http://compare.buscape.com.br/monitor.html"/>
                <link type="xml" url="http://sandbox.buscape.com/service/findProductList/<APPLICATION_ID>/?categoryId=36"/>
            </links>
            <name>Monitor</name>
        </category>
        <product id="122312" categoryId="36" totalSellers="19" fullDescription="true">
            <productName>Samsung SyncMaster 632NW LCD 15,6 Polegadas</productName>
            <priceMin>329.80</priceMin>
            <priceMax>1049.00</priceMax>
            <links>
                <link type="product" url="http://compare.buscape.com.br/samsung-syncmaster-632nw-lcd-15-6-polegadas.html"/>
                <link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=122312"/>
                <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/<APPLICATION_ID>/?productId=122312"/>
            </links>
            <thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/36/190x190_122312_1.jpg"/>
            <rating>
                <userAverageRating>
                    <numComments>1</numComments>
                    <rating>9.6</rating>
                    <links>
                        <link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/<APPLICATION_ID>/?productId=122312"/>
                    </links>
                    <specification>
                        <item label="Design">
                            <value>10.0</value>
                        </item>
                        <item label="Custo-Benefício">
                            <value>8.0</value>
                        </item>
                        <item label="Qualidade da Imagem">
                            <value>10.0</value>
                        </item>
                        <item label="Funções e Características">
                            <value>10.0</value>
                        </item>
                        <item label="Durabilidade">
                            <value>10.0</value>
                        </item>
                    </specification>
                </userAverageRating>
            </rating>
            <specification>
                <links>
                    <link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/<APPLICATION_ID>/?productId=122312"/>
                </links>
                <item label="Tamanho da Tela">
                    <value>15,6 Polegadas</value>
                </item>
                <item label="Tipo de Tela">
                    <value>LCD</value>
                </item>
                <item label="Tela Plana">
                    <value>Sim</value>
                </item>
                <item label="Widescreen">
                    <value>Sim</value>
                </item>
                <item label="Resolução Máxima">
                    <value>1366 x 768 Pixel</value>
                </item>
            </specification>
            <productDetails>
                <specification label="Informações Básicas">
                    <item label="Marca">
                        <value>Samsung</value>
                    </item>
                    <item label="Linha">
                        <value>SyncMaster</value>
                    </item>
                    <item label="Modelo">
                        <value>632NW</value>
                    </item>
                </specification>
                <specification label="Especificações Técnicas">
                    <item label="Largura">
                        <value>382 mm</value>
                    </item>
                    <item label="Altura">
                        <value>308 mm</value>
                    </item>
                    <item label="Profundidade">
                        <value>159 mm</value>
                    </item>
                    <item label="Peso">
                        <value>3,5 Kg</value>
                    </item>
                </specification>
                <specification label="Conexões">
                    <item label="Compatibilidade Plug & Play">
                        <value>Sim</value>
                    </item>
                </specification>
                <specification label="Características do Display">
                    <item label="Tamanho da Tela">
                        <value>15,6 Polegadas</value>
                    </item>
                    <item label="Tipo de Tela">
                        <value>LCD</value>
                    </item>
                    <item label="Tela Plana">
                        <value>Sim</value>
                    </item>
                    <item label="Ângulo de Visão Horizontal">
                        <value>90 Graus</value>
                    </item>
                    <item label="Ângulo de Visão Vertical">
                        <value>65 Graus</value>
                    </item>
                    <item label="Widescreen">
                        <value>Sim</value>
                    </item>
                    <item label="Resolução Máxima">
                        <value>1366 x 768 Pixel</value>
                    </item>
                    <item label="Taxa de Atualização na Resolução Máxima">
                        <value>60 Hz</value>
                    </item>
                    <item label="Número de Cores">
                        <value>16,7 milhões</value>
                    </item>
                    <item label="Brilho">
                        <value>250 cd/m²</value>
                    </item>
                    <item label="Contraste">
                        <value>2000:1</value>
                    </item>
                    <item label="Tempo de Resposta">
                        <value>8 ms</value>
                    </item>
                </specification>
            </productDetails>
        </product>
    </Result>

Erros

Conforme visualizado em ResultDetails, a resposta pode retornar códigos de erros.

Aviso aos desenvolvedores

Caso o seu aplicativo seja executado em um servidor, é necessário informar aos webservices do Buscapé o IP do usuário que acessa o seu servidor. O IP do usuário deve ser informado através do parâmetro clientIp. Caso o seu aplicativo seja executado diretamente na máquina do usuário final, como aplicações mobile ou javascript, não é necessário informar o IP do usuário. Se, por exemplo, o IP do usuário que acessou o seu servidor seja 200.200.200.200, a chamada deveria ser feita assim:

http://sandbox.buscape.com/service/viewProductDetails/<application_id>/?productId=<productId>&clientIp=200.200.200.200

Caso o aplicativo, sistema ou site utilize cache, o mesmo deverá ser de, no máximo, uma hora para produtos e categorias. No caso de ofertas, como o clique é validado através do IP do usuário e pela hora do clique, o cache não pode existir pois, se dois IP's acessam o mesmo link de oferta, o clique é invalidado.

Topo