Como obter uma lista de categorias do BuscaPé usando o Wrapper .NET

Vamos utilizar o método FindCategoryList da classe Apiki_BuscaPe_API para obter as listas de categorias que desejamos.

Nossa aplicação efetuará uma requisição ao serviço Find Category List
da API do BuscaPé, informando o ID de uma categoria ou palavras-chave. O
servidor do BuscaPé, por sua vez, efetuará a pesquisa e nos retornará
os dados encontrados no formato XML.

Como utilizar?

Inicialmente, realize o download do Wrapper .Net, agora hospedado no site Github para uma melhor integração com a nossa grande comunidade de desenvolvedores.

Após o download, adicione a classe em seu aplicativo e instancie um novo objeto para utilizar seus métodos.

Apiki_Buscape_API.Apiki_Buscape_API apiBuscape = new Apiki_Buscape_API.Apiki_Buscape_API( "564771466d477a4458664d3d" );

Podemos informar também, ao construtor da classe, o código do país de
origem e o formato de retorno dos dados. Caso não sejam informados,
esses parâmetros assumirão os valores padrão, “BR” e “XML”,
respectivamente.

Após instanciar a classe, invocamos o método FindCategoryList,
informando o ID de uma categoria raiz, ou palavras-chave para recuperar a
lista de categorias.

• Busca as categorias relacionadas à categoria de ID 1:

apiBuscape.FindCategoryList(1, string.Empty, string.Empty);

• Busca as categorias relacionadas à categoria de ID 1 com a palavra-chave “TV”:

 apiBuscape.FindCategoryList(1, "TV", string.Empty);

Como é o retorno do método?

Por padrão, o método retorna os dados no formato XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="100" totalResultsAvailable="100" 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-03-15T09:17:09.846</date>
        <elapsedTime>14</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <subCategory hasOffer="false" isFinal="true" parentCategoryId="1" id="2852">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2852.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/tv.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=2852&amp;keyword=tv&amp;sourceId=9262544"/>
        </links>
        <name>TV</name>
    </subCategory>
    <subCategory hasOffer="true" isFinal="true" parentCategoryId="5845" id="9091">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9091.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/emissoras-de-tv.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=9091&amp;keyword=tv&amp;sourceId=9262544"/>
        </links>
        <name>Emissoras de TV</name>
    </subCategory>
    <subCategory hasOffer="true" isFinal="true" parentCategoryId="1" id="9463">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9463.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/suporte-para-tv-monitor.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=9463&amp;keyword=tv&amp;sourceId=9262544"/>
        </links>
        <name>Suporte para TV / Monitor</name>
    </subCategory>
    <subCategory hasOffer="true" isFinal="true" parentCategoryId="1" id="9462">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9462.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/decodificador-receptor-para-tv.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=9462&amp;keyword=tv&amp;sourceId=9262544"/>
        </links>
        <name>Decodificador / Receptor para TV</name>
    </subCategory>
    <subCategory hasOffer="true" isFinal="true" parentCategoryId="6108" id="7523">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7523.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/assinaturas-de-tv-a-cabo.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=7523&amp;keyword=tv&amp;sourceId=9262544"/>
        </links>
        <name>Assinaturas de TV a Cabo</name>
    </subCategory>
    <subCategory hasOffer="true" isFinal="true" parentCategoryId="5845" id="8113">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/8113.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/instalacao-de-circuito-fechado-de-tv.html?mdsrc=9262544"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=8113&amp;keyword=tv&amp;sourceId=9262544"/>
        </links>
        <name>Instalação de Circuito Fechado de TV</name>
    </subCategory>
</Result>

Podemos também ter o retorno dos dados em JSON, para isso basta que tenhamos informado o parâmetro format no construtor da classe:

{"details":{"message":"success","elapsedtime":15,"status":"success","code":0,"applicationversion":"1.0.0.0","date":{"minute":22,"valid":true,"timezone":-2147483648,"second":9,"millisecond":109,"month":3,"year":2011,"hour":9,"day":15,"xmlschematype":{"namespaceuri":"http://www.w3.org/2001/XMLSchema","prefix":"","localpart":"dateTime"},"eonandyear":{"lowestsetbit":0}},"applicationpath":"http://bws-apps.buscape.com/mobile/update","applicationid":"564771466d477a4458664d3d"},"subcategory":[{"subcategory":{"id":2852,"thumbnail":{"url":"http://imagem.buscape.com.br/bp5/categorias/2852.jpg"},"hasoffer":false,"name":"TV","parentcategoryid":1,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/tv.html?mdsrc=9262544"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=2852&keyword=tv&sourceId=9262544&format=json"}}],"isfinal":true}},{"subcategory":{"id":9091,"thumbnail":{"url":"http://imagem.buscape.com.br/bp5/categorias/9091.jpg"},"hasoffer":true,"name":"Emissoras de TV","parentcategoryid":5845,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/emissoras-de-tv.html?mdsrc=9262544"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=9091&keyword=tv&sourceId=9262544&format=json"}}],"isfinal":true}},{"subcategory":{"id":9463,"thumbnail":{"url":"http://imagem.buscape.com.br/bp5/categorias/9463.jpg"},"hasoffer":true,"name":"Suporte para TV / Monitor","parentcategoryid":1,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/suporte-para-tv-monitor.html?mdsrc=9262544"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=9463&keyword=tv&sourceId=9262544&format=json"}}],"isfinal":true}},{"subcategory":{"id":9462,"thumbnail":{"url":"http://imagem.buscape.com.br/bp5/categorias/9462.jpg"},"hasoffer":true,"name":"Decodificador / Receptor para TV","parentcategoryid":1,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/decodificador-receptor-para-tv.html?mdsrc=9262544"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=9462&keyword=tv&sourceId=9262544&format=json"}}],"isfinal":true}},{"subcategory":{"id":7523,"thumbnail":{"url":"http://imagem.buscape.com.br/bp5/categorias/7523.jpg"},"hasoffer":true,"name":"Assinaturas de TV a Cabo","parentcategoryid":6108,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/assinaturas-de-tv-a-cabo.html?mdsrc=9262544"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=7523&keyword=tv&sourceId=9262544&format=json"}}],"isfinal":true}},{"subcategory":{"id":6106,"thumbnail":{"url":"http://imagem.buscape.com.br/bp5/categorias/6106.jpg"},"hasoffer":true,"name":"Outros Acessórios para Instrumentos Musicais","parentcategoryid":2792,"links":[{"link":{"type":"category","url":"http://compare.buscape.com.br/outros-acessorios-para-instrumentos-musicais.html?mdsrc=9262544"}},{"link":{"type":"xml","url":"http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=6106&keyword=tv&sourceId=9262544&format=json"}}],"isfinal":true}}],"totalresultsavailable":100,"totalresultsreturned":100}

Conheça mais sobre a API do BuscaPé com a nossa documentação. E aprenda mais sobre os Wrappers em PHP e .NET.