Use o código de barras de um produto para obter uma lista de ofertas através da API do BuscaPé

Informe apenas o código de barras de um produto e obtenha uma lista de ofertas relacionadas a ele.

Para obter uma lista de ofertas de produtos através da API do BuscaPé, usaremos o serviço FindOfferList. Saiba mais a respeito desse serviço, visitando nosso tutorial ou, se preferir, veja o vídeo explicativo para tal serviço.

Como funciona esse serviço?

Sua aplicação informa o código de barras ao serviço FindOfferList, que recebe a requisição, busca a lista de ofertas no BuscaPé e retorna os dados, por padrão, em XML.

Como requisitar esse serviço ao BuscaPé?

A API do BuscaPé utiliza a tecnologia REST no tratamento de requisições, sendo possível construir facilmente uma URL para ser executada em seu navegador, linha de comando ou código. Veja como utilizar as URLs para esse serviço:

http://sandbox.buscape.com/service/findOfferList//application_id/country_code/?barcode=barcode

Quais formatos de retorno posso obter?

Esse serviço, assim como a API do BuscaPé, nos permite por padrão obter os dados de retorno em formato XML. Podemos também obter esse retorno em formato JSON. Para isso, passe o parâmetro &format=json ao final de sua URL REST requisitada.

Como os dados são retornados por esse serviço?

Para exemplificar como os dados são retornados pelo serviço FindOfferList, vamos requisitar, à API do BuscaPé, uma lista de ofertas em que o código de barras seja “9788576080855?.

http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?barcode=9788576080855

<?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" totalResultsSellers="1" totalResultsReturned="1" totalResultsAvailable="1" xsi:schemaLocation="http://developer.buscape.com/admin/buscape.xsd">
    <details>
        <applicationID>564771466d477a4458664d3d</applicationID>
        <applicationVersion>1.0.0.0</applicationVersion>
        <applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
        <date>2011-07-19T10:54:42.191-03:00</date>
        <elapsedTime>4</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="false" isFinal="true" parentCategoryId="3482" id="3482">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3482.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/livros.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=3482"/>
        </links>
        <name>Livros</name>
    </category>
    <product id="1857608085" eco="false" hasMetaSearch="false" categoryId="3482" totalSellers="1" fullDescription="true">
        <productName>Use a Cabeça! Jsp - Brian Bashan, Kathy Sierra, Bert Bates (8576080850)</productName>
        <currency abbreviation="BRL"/>
        <priceMin>139.90</priceMin>
        <priceMax>139.90</priceMax>
        <links>
            <link type="product" url="http://compare.buscape.com.br/use-a-cabeca-jsp-brian-bashan-kathy-sierra-bert-bates-8576080850.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=1857608085"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=1857608085"/>
        </links>
        <thumbnail url="http://imagem.buscape.com.br/capas/livros/058/080/200x200_8576080850.jpg"/>
        <rating>
            <userAverageRating>
                <numComments>0</numComments>
                <rating>0.0</rating>
                <links>
                    <link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=1857608085"/>
                </links>
            </userAverageRating>
        </rating>
        <specification>
            <links>
                <link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=1857608085"/>
            </links>
        </specification>
    </product>
    <offer productId="1857608085" id="71606813" categoryId="3482">
        <offerName>USE A CABEÇA ! : SERVLETS AND JSP ( 9788576080855 )</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=MgQNFmVuHTcRPChrbCdvDwcBLBxpZx0aPyk5c3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3Oitjb2ZraWhuZm5ma3gzOjoqMGNoZ2hpbGlnaXgzOj8uLmNvbm5lNioqLmRxcSkpKXA5MTE5MjtwPTEzcSssMmEvYzYqKi57bR97bBh7bBgtPzA6PDEmcDwrLT0_LjtwPTEze2wYLTssKDc9O3tsGDg3MDoRODg7LBI3LSp7bBhraGppaW9qaGg6amlpP2pqa2ZoaGo6bTp7bBh7bRg8Pyw9MTo7e20aZ2lmZmtpaG5mbmZra3gtP2MaeC0wKiRjb3grLTljHxgPNB0QFjJtBB8cPxYsAREHEhgsagEsFg44LAkVOBodD2VvZRwMZWVlbmVuZW5lbmVuZW5lbmVpb2huaGZvbWVucG5lbnBuZW9lZW5l"/>
        </links>
        <thumbnail url="http://thumbnails.buscape.com.br/offerimg/t/r/travessa/9da/ed8/100x100_f8b08908362A80%252DA433%252D4BB5%252DAA3E%252D08E040BF1537.jpg"/>
        <price>
            <currency abbreviation="BRL"/>
            <value>139.90</value>
            <parcel>
                <value>46.64</value>
                <number>3</number>
                <interest>0.0</interest>
            </parcel>
        </price>
        <seller pagamentoDigital="false" isTrustedStore="true" id="141646">
            <sellerName>Livraria da Travessa</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo141646.gif"/>
            <links>
                <link type="seller" url="http://www.travessa.com.br"/>
            </links>
            <contacts>
                <contact label="Atendimento" value="21-31389554"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>4112</numComments>
                    <rating>8.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>4112</numComments>
                    <rating>diamante</rating>
                </eBitRating>
            </rating>
            <coupon id="22545">
                <link type="coupon" url="http://preco.buscape.com.br/cupom/cupom.asp?lkpm=22545&amp;id_prod=71606813&amp;id_emp=141646"/>
                <description>Frete Grátis para algumas regiões</description>
                <type>frete</type>
            </coupon>
        </seller>
    </offer>
</Result>