Home > Home > Documentación > Detalles técnicos de un producto

Detalles técnicos de un producto

Este servicio devuelve los detalles técnicos de un producto en particular.

¿Cómo funciona?

Funcionamento dos detalhes técnicos do produto

En esta página:
  1. Aplicación envía una solicitud informando el identificador de producto.
  2. Servicio recibe la solicitud y busca los detalles del producto en Buscapé.
  3. Service devuelve la información del producto en el formato XML para su aplicación.

Formatos de URL

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

Formatos de respuesta

El formato de respuesta es XML.

Si desea utilizar el formato de respuesta JSON, agregue el format=json.

Solicitud de Muestras

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

Documento XSD (esquema XML)

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

Parámetros

Parámetros Tipo Descripción
productId Int Producto ID

Campos de respuesta

Result

Campos Tipo Descripción
details ResultDetails Solicitud de información
category CategoryType Datos de la categoría actual
totalResultsAvailable Int Total de artículos disponibles
totalResultsReturned Int Total de devolución
totalPages Int Total de páginas
page Int El número de página actual
match String Devuelve el tipo de palabra clave de búsqueda
  • all: Investigación perfecto, todas las palabras clave que se encuentran
  • any: una parte de investigación, algunas palabras clave que se encuentran
  • none: La búsqueda no encontrado

ResultDetails

Campos Tipo Descripción
applicationID String ID de aplicación
date String Fecha y hora de la solicitud
elapsedTime Long Tiempo de ejecución de la solicitud en milisegundos
status String Condición Jurídica y Social de Respuesta
code Int Código de respuesta
message String Responder mensaje

CategoryType

Campos Tipo Descripción
id Int Categoría ID
parentCategoryId Int Categoría de ID
isFinal Boolean TRUE si se trata de una categoría final
name String Nombre de la categoría
links LinksType Lista de Link
  • category: URL de la categoría en Buscapé
  • XML: URL de la oferta de servicios de búsqueda o categoría de productos por ID
thumbnail ThumbnailType Categoría imagen

ProductType

Campos Tipo Descripción
id Int Identificación de producto
categoryId Int Categoría ID
totalSellers Int Total de empresas con ofertas para este producto
productName String Nombre del producto
priceMin String Precio mínimo
priceMax String Precio máximo
links LinkType Links del producto
  • XML: URL de la oferta del servicio de búsqueda por identificador de producto
  • product: URL del producto en Buscapé
  • specification: URL de la especificación del producto en Buscapé
thumbnail ThumbnailType Imagen del producto
rating RatingType Evaluación del producto
specification SpecificationType Detalles del producto

LinksType

Campos Tipo Descripción
link LinkType Link

LinkType

Campos Tipo Descripción
type String Tipo de link
url String Dirección del Link

ThumbnailType

Campos Tipo Descripción
url String dirección de imagen

RatingType

Campos Tipo Descripción
userAverageRating UserRatingType Evaluación de los usuarios

UserRatingType

Campos Tipo Descripción
numComments Int Número de comentarios
rating String Promedio de calificaciones de los usuarios
link LinkType Link evaluación
  • XML: URL de hacer Serviço de avalição dos Usuario pelo ID do produto
specification SpecificationType Evaluación de los elementos del producto

ProductDetailsType

Campos Tipo Descripción
specification SpecificationType List of technical specifications of the product

SpecificationType

Campos Tipo Descripción
item ItemListType Lista de artículos especificación
links LinkType Links
label String Lista de artículos especificación

ItemListType

Campos Tipo Descripción
label String Nombre del artículo
value String Relación del artículo

Ejemplo de respuesta

Detalles de la búsqueda de productos 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</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>

Errores

Como se observa en ResultDetails, la respuesta puede devolver códigos de error.

Aviso a los desarrolladores

Si la aplicación se ejecuta en un servidor, debe informar a los servicios web Buscapé el IP del usuario para acceder a su servidor. El IP del usuario debe ser informado por el parámetro clientIp. Si la aplicación se ejecuta directamente en la máquina del usuario final, tales como aplicaciones móviles o javascript, no es necesario informar el IP del usuario. Si, por ejemplo, el IP del usuario que accede a su servidor es 200.200.200.200, la llamada debe hacerse así:

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