A API do BuscaPé coloca à disposição um serviço pelo qual podemos obter os detalhes técnicos dos produtos.
O que são os detalhes técnicos?
Esses detalhes ou dados são informações extras, de ordem técnica,
que ajudam na identificação e na valorização de um produto. Geralmente,
eles são importantes para o comprador distinguir um produto de outro e
tomar decisão de compra. É de responsabilidade do vendedor a sua
inclusão.
Como o recurso funciona?
Informando o ID do produto, a aplicação efetua uma requisição ao serviço View Product Details, disponibilizado pela API do BuscaPé, e retorna todos os detalhes encontrados.
Informando o ID do produto, a aplicação efetua uma requisição ao serviço View Product Details, disponibilizado pela API do BuscaPé, e retorna todos os detalhes encontrados.
Como utilizar o serviço?
A API do BuscaPé utiliza a tecnologia REST para tratar as requisições. Assim, torna-se mais fácil montar a URL para ser executada, seja no navegador, na linha de comando ou no código.
Abaixo podemos ver o formato padrão da URL para a requisição do serviço:
http://sandbox.buscape.com/service/viewProductDetails/application_id/?productId=product_Id
Para realizar a requisição corretamente, precisamos informar os IDs
da aplicação e do produto do qual desejamos obter os detalhes
técnicos. Caso não possua um ID para a sua aplicação, aprenda como
obtê-lo neste tutorial.
Retorno
Os dados requisitados à API do BuscaPé, por padrão, são retornados no formato XML. Também é possível retorná-los em JSON. Abaixo temos dois exemplos de requisições feitas à API, um retornando os dados em XML e outro em JSON.
– XML:
Como XML é o padrão utilizado pela API do BuscaPé, não é necessário
nenhum parâmetro adicional para retornar os dados nesse formato.
http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/?productId=197155
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" match="all" page="1" totalPages="1" totalResultsReturned="1" totalResultsAvailable="1" xsi:schemaLocation="http://developer.buscape.com/xsd/buscape.xsd">
<details>
<applicationID>564771466d477a4458664d3d</applicationID>
<applicationVersion>1.0.0.0</applicationVersion>
<applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
<date>2010-09-21T15:20:48.010</date>
<elapsedTime>16</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>
<category hasOffer="false" isFinal="true" parentCategoryId="6420" id="77">
<thumbnail url="http://imagem2.buscape.com.br/bp5/categorias/77.jpg"/>
<links>
<link type="category" url="http://compare.buscape.com.br/celular-e-smartphone.html?"/>
<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77"/>
</links>
<name>Celular e Smartphone</name>
</category>
<product id="197155" categoryId="77" totalSellers="18" fullDescription="true">
<productName>Nokia N97 GSM Desbloqueado</productName>
<productShortName>Nokia N97 Desbloqueado</productShortName>
<currency abbreviation="BRL"/>
<priceMin>325.00</priceMin>
<priceMax>5999.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/nokia-n97-gsm-desbloqueado.html?"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=197155"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?productId=197155"/>
</links>
<thumbnail url="http://imagem2.buscape.com.br/thumbs/ensopado/77/190x190_197155_1.jpg"/>
<rating>
<userAverageRating>
<numComments>35</numComments>
<rating>9.2</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/?productId=197155"/>
</links>
<specification>
<item label="Duração da Bateria">
<value>7.4</value>
</item>
<item label="Design">
<value>9.4</value>
</item>
<item label="Custo-Benefício">
<value>8.2</value>
</item>
<item label="Facilidade de Uso">
<value>9.2</value>
</item>
<item label="Funções e Características">
<value>9.8</value>
</item>
<item label="Durabilidade">
<value>9.2</value>
</item>
<item label="Display">
<value>9.8</value>
</item>
<item label="Operadora">
<value>9.2</value>
</item>
<item label="Câmera">
<value>9.8</value>
</item>
</specification>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/?productId=197155"/>
</links>
<item label="Câmera">
<value>5.0 MP</value>
</item>
<item label="Funções Extras">
<value>Comando de Voz</value>
<value>GPS</value>
<value>Grava Video</value>
<value>Gravador de Voz</value>
<value>Java</value>
<value>MP3 Player</value>
<value>Rádio</value>
<value>Reproduz Video</value>
<value>Viva Voz</value>
</item>
<item label="3G">
<value>Sim</value>
</item>
<item label="Slots de Expansão">
<value>MicroSD</value>
</item>
<item label="Tipos de Conexão">
<value>Bluetooth</value>
<value>EDGE</value>
<value>Fone de Ouvido</value>
<value>GPRS</value>
<value>Micro-USB</value>
<value>USB</value>
<value>WAP</value>
<value>Wi-Fi</value>
</item>
</specification>
<productDetails>
<specification label="Especificações Técnicas">
<item label="Bateria">
<value>Li-Ion</value>
</item>
<item label="Autonomia em Stand-by">
<value>430 Horas</value>
</item>
<item label="Autonomia em Conversação">
<value>9,5 Horas</value>
</item>
<item label="Largura">
<value>55,3 mm</value>
</item>
<item label="Altura">
<value>117 mm</value>
</item>
<item label="Profundidade">
<value>18,5 mm</value>
</item>
<item label="Peso">
<value>150 g</value>
</item>
</specification>
<specification label="Conectividade">
<item label="Tipos de Conexão">
<value>Bluetooth</value>
<value>EDGE</value>
<value>Fone de Ouvido</value>
<value>GPRS</value>
<value>Micro-USB</value>
<value>USB</value>
<value>WAP</value>
<value>Wi-Fi</value>
</item>
<item label="Modos de Entrada">
<value>Teclado</value>
<value>Touch-screen</value>
</item>
</specification>
<specification label="Processador">
<item label="Processador">
<value>ARM 11</value>
</item>
<item label="Velocidade do Processador">
<value>434</value>
</item>
</specification>
<specification label="Software">
<item label="Sistema Operacional">
<value>Symbian OS</value>
</item>
</specification>
<specification label="Características">
<item label="Cores da Tela">
<value>16,7 milhões cores</value>
</item>
<item label="Cores da Tela Externa">
<value>Não se aplica</value>
</item>
<item label="Resolução">
<value>640 x 360 pixels</value>
</item>
<item label="Formato">
<value>Slider</value>
</item>
<item label="Memória Interna">
<value>32768 MB</value>
</item>
<item label="Slots de Expansão">
<value>MicroSD</value>
</item>
<item label="Banda">
<value>Quadri-Band</value>
</item>
<item label="Antena">
<value>Interna</value>
</item>
<item label="Teclado">
<value>QWERTY Completo</value>
</item>
<item label="Tamanho">
<value>3.5 Polegadas</value>
</item>
</specification>
<specification label="Funcionalidades">
<item label="Câmera">
<value>5.0 MP</value>
</item>
<item label="Zoom">
<value>14x</value>
</item>
<item label="Flash Embutido">
<value>Sim</value>
</item>
<item label="Funções Extras">
<value>Comando de Voz</value>
<value>GPS</value>
<value>Grava Video</value>
<value>Gravador de Voz</value>
<value>Java</value>
<value>MP3 Player</value>
<value>Rádio</value>
<value>Reproduz Video</value>
<value>Viva Voz</value>
</item>
<item label="3G">
<value>Sim</value>
</item>
<item label="Mensagens Escritas">
<value>E-mail</value>
<value>MMS (texto, som, imagem)</value>
<value>SMS (texto)</value>
</item>
<item label="Modo Entrada de Texto">
<value>T-9</value>
</item>
<item label="Tipo de Toque">
<value>MP3</value>
<value>Vibracall</value>
</item>
</specification>
<specification label="Informações Básicas">
<item label="Marca">
<value>Nokia</value>
</item>
<item label="Modelo">
<value>N97</value>
</item>
<item label="Operadora">
<value>Desbloqueado</value>
</item>
<item label="Tecnologia">
<value>GSM</value>
</item>
</specification>
</productDetails>
</product>
</Result>
– JSON:
Para alterar o formato padrão e retornar os dados em JSON, adicione ao final da URL o parâmetro format=json.
http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/?productId=197155&format=json
{"product":[{"product":{"totalsellers":18,"pricemax":"5999.00","productshortname":"Nokia N97 Desbloqueado","fulldescription":true,"links":[{"link":{"type":"product","url":"http://compare.buscape.com.br/nokia-n97-gsm-desbloqueado.html?"}},{"link":{"type":"specification","url":"http://compare.buscape.com.br/prod_ficha?idu=197155"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?productId=197155&format=json"}}],"pricemin":"325.00","currency":{"abbreviation":"BRL"},"productdetails":[{"specification":{"item":[{"item":{"value":["Li-Ion"],"label":"Bateria"}},{"item":{"value":["430 Horas"],"label":"Autonomia em Stand-by"}},{"item":{"value":["9,5 Horas"],"label":"Autonomia em Conversação"}},{"item":{"value":["55,3 mm"],"label":"Largura"}},{"item":{"value":["117 mm"],"label":"Altura"}},{"item":{"value":["18,5 mm"],"label":"Profundidade"}},{"item":{"value":["150 g"],"label":"Peso"}}],"label":"Especificações Técnicas"}},{"specification":{"item":[{"item":{"value":["Bluetooth","EDGE","Fone de Ouvido","GPRS","Micro-USB","USB","WAP","Wi-Fi"],"label":"Tipos de Conexão"}},{"item":{"value":["Teclado","Touch-screen"],"label":"Modos de Entrada"}}],"label":"Conectividade"}},{"specification":{"item":[{"item":{"value":["ARM 11"],"label":"Processador"}},{"item":{"value":["434"],"label":"Velocidade do Processador"}}],"label":"Processador"}},{"specification":{"item":[{"item":{"value":["Symbian OS"],"label":"Sistema Operacional"}}],"label":"Software"}},{"specification":{"item":[{"item":{"value":["16,7 milhões cores"],"label":"Cores da Tela"}},{"item":{"value":["Não se aplica"],"label":"Cores da Tela Externa"}},{"item":{"value":["640 x 360 pixels"],"label":"Resolução"}},{"item":{"value":["Slider"],"label":"Formato"}},{"item":{"value":["32768 MB"],"label":"Memória Interna"}},{"item":{"value":["MicroSD"],"label":"Slots de Expansão"}},{"item":{"value":["Quadri-Band"],"label":"Banda"}},{"item":{"value":["Interna"],"label":"Antena"}},{"item":{"value":["QWERTY Completo"],"label":"Teclado"}},{"item":{"value":["3.5 Polegadas"],"label":"Tamanho"}}],"label":"CaracterÃsticas"}},{"specification":{"item":[{"item":{"value":["5.0 MP"],"label":"Câmera"}},{"item":{"value":["14x"],"label":"Zoom"}},{"item":{"value":["Sim"],"label":"Flash Embutido"}},{"item":{"value":["Comando de Voz","GPS","Grava Video","Gravador de Voz","Java","MP3 Player","Rádio","Reproduz Video","Viva Voz"],"label":"Funções Extras"}},{"item":{"value":["Sim"],"label":"3G"}},{"item":{"value":["E-mail","MMS (texto, som, imagem)","SMS (texto)"],"label":"Mensagens Escritas"}},{"item":{"value":["T-9"],"label":"Modo Entrada de Texto"}},{"item":{"value":["MP3","Vibracall"],"label":"Tipo de Toque"}}],"label":"Funcionalidades"}},{"specification":{"item":[{"item":{"value":["Nokia"],"label":"Marca"}},{"item":{"value":["N97"],"label":"Modelo"}},{"item":{"value":["Desbloqueado"],"label":"Operadora"}},{"item":{"value":["GSM"],"label":"Tecnologia"}}],"label":"Informações Básicas"}}],"id":197155,"categoryid":77,"thumbnail":{"url":"http://imagem2.buscape.com.br/thumbs/ensopado/77/190x190_197155_1.jpg"},"specification":{"item":[{"item":{"value":["5.0 MP"],"label":"Câmera"}},{"item":{"value":["Comando de Voz","GPS","Grava Video","Gravador de Voz","Java","MP3 Player","Rádio","Reproduz Video","Viva Voz"],"label":"Funções Extras"}},{"item":{"value":["Sim"],"label":"3G"}},{"item":{"value":["MicroSD"],"label":"Slots de Expansão"}},{"item":{"value":["Bluetooth","EDGE","Fone de Ouvido","GPRS","Micro-USB","USB","WAP","Wi-Fi"],"label":"Tipos de Conexão"}}],"links":[{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/?productId=197155&format=json"}}]},"rating":{"useraveragerating":{"specification":[{"item":{"value":["7.4"],"label":"Duração da Bateria"}},{"item":{"value":["9.4"],"label":"Design"}},{"item":{"value":["8.2"],"label":"Custo-BenefÃcio"}},{"item":{"value":["9.2"],"label":"Facilidade de Uso"}},{"item":{"value":["9.8"],"label":"Funções e CaracterÃsticas"}},{"item":{"value":["9.2"],"label":"Durabilidade"}},{"item":{"value":["9.8"],"label":"Display"}},{"item":{"value":["9.2"],"label":"Operadora"}},{"item":{"value":["9.8"],"label":"Câmera"}}],"links":[{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/?productId=197155&format=json"}}],"rating":"9.2","numcomments":35}},"productname":"Nokia N97 GSM Desbloqueado"}}],"category":{"id":77,"thumbnail":{"url":"http://imagem2.buscape.com.br/bp5/categorias/77.jpg"},"hasoffer":false,"name":"Celular e Smartphone","parentcategoryid":6420,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/celular-e-smartphone.html?"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77&format=json"}}],"isfinal":true},"details":{"message":"success","elapsedtime":13,"status":"success","code":0,"applicationversion":"1.0.0.0","date":{"minute":32,"valid":true,"timezone":-2147483648,"second":12,"millisecond":902,"month":9,"year":2010,"hour":15,"day":21,"xmlschematype":{"namespaceuri":"http://www.w3.org/2001/XMLSchema","prefix":"","localpart":"dateTime"},"eonandyear":{"lowestsetbit":1}},"applicationpath":"http://bws-apps.buscape.com/mobile/update","applicationid":"564771466d477a4458664d3d"},"page":1,"totalresultsavailable":1,"totalpages":1,"match":"all","totalresultsreturned":1}
Wrappers
Para facilitar a integração de sua aplicação à API do BuscaPé,
disponibilizamos classes de wrapper que implementam todos os serviços
disponibilizados. Atualmente, as temos em PHP e .NET.
Aprenda mais com a nossa documentação sobre detalhes técnicos de um produto e como funciona a API do BuscaPé. Conheça também outros serviços oferecidos.
Participe deixando seu comentário abaixo e ajude-nos a melhorar ainda mais nossos tutoriais e wrappers.
De 0 a 10, o quanto você recomendaria este artigo para um amigo?