Como obter avaliações de usuários sobre um produto usando a API do BuscaPé

Para conseguirmos obter as avaliações dos usuários sobre um determinado produto, utilizaremos o serviço View User Ratings.

Como funciona esse serviço?

Informando o ID do produto, o serviço View User Rattings busca os dados no BuscaPé e os retorna para sua aplicação, por padrão, em formato 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 um exemplo, utilizando um formato padrão de URL para esse serviço:

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

É obrigatório informar os IDs da sua aplicação e também do produto do qual você deseja que sejam retornadas as avaliações dos usuários.

Formatos de retorno

Por padrão, todos os serviços da API do BuscaPé têm como formato de retorno o XML.

<?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" totalNotRecommended="1" totalRecommended="18" totalPages="4" totalResultsReturned="5" totalResultsAvailable="19" 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-10-19T09:51:28.095</date>
        <elapsedTime>347</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="false" isFinal="true" parentCategoryId="116" id="131">
        <thumbnail url="http://imagem2.buscape.com.br/bp5/categorias/131.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/freezer.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=131&amp;sourceId=9262544"/>
        </links>
        <name>Freezer</name>
    </category>
    <product id="27048" categoryId="131" totalSellers="9" fullDescription="true">
        <productName>Electrolux FE22 Vertical Branco</productName>
        <productShortName>Freezer Electrolux FE22</productShortName>
        <currency abbreviation="BRL"/>
        <priceMin>1087.00</priceMin>
        <priceMax>1329.90</priceMax>
        <links>
            <link type="product" url="http://compare.buscape.com.br/electrolux-fe22-vertical-branco.html?mdsrc=9262544"/>
            <link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=27048"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?productId=27048&amp;sourceId=9262544"/>
        </links>
        <thumbnail url="http://imagem2.buscape.com.br/thumbs/ensopado/131/190x190_27048_1.jpg"/>
        <rating>
            <userAverageRating>
                <numComments>19</numComments>
                <rating>8.8</rating>
                <links>
                    <link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/?productId=27048&amp;sourceId=9262544"/>
                </links>
                <specification>
                    <item label="Design">
                        <value>7.4</value>
                    </item>
                    <item label="Custo-Benefício">
                        <value>9.2</value>
                    </item>
                    <item label="Funções e Características">
                        <value>9.0</value>
                    </item>
                    <item label="Durabilidade">
                        <value>8.6</value>
                    </item>
                    <item label="Capacidade de Armazenamento">
                        <value>8.8</value>
                    </item>
                    <item label="Qualidade do Material">
                        <value>9.2</value>
                    </item>
                </specification>
            </userAverageRating>
        </rating>
        <specification>
            <links>
                <link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/?productId=27048&amp;sourceId=9262544"/>
            </links>
            <item label="Capacidade Total">
                <value>173 Litros</value>
            </item>
            <item label="Funções e Características">
                <value>Cestos</value>
                <value>Degelo</value>
                <value>Pés Niveladores</value>
            </item>
            <item label="Número de Gavetas">
                <value>6</value>
            </item>
        </specification>
    </product>
</Result>

Também podemos obtê-lo em JSON, bastando acrescentar ao final da URL anterior &format=json:

http://sandbox.buscape.com/service/viewUserRatings/<application_id>/?productId=<product_id>&format=json

Como XML é padrão, não é necessário informar parâmetro algum para retornos utilizando esse tipo de formato.

Wrappers para uma melhor integração

O BuscaPé Developer disponibiliza wrappers em PHP e .NET para ajudá-lo na integração. Ao instanciar a classe, chame o método ViewUserRatings para PHP e .NET, informando os parâmetros requisitados pelo wrapper.

Aprenda mais sobre como funciona a API do BuscaPé e o Wrapper PHP.