API
La API (Application Programming Interface) de Buscapé es un conjunto de funciones y las normas para la creación de aplicaciones personalizadas, que necesitan utilizar la base de datos de productos, ofertas y servicios ofrecidos por Buscapé.
¿Cómo funciona?
Para integrar el API de Buscapé primero debe obtener un identificador para su aplicación, para ser utilizado en todas las solicitudes realizadas a un servicio que se solicita. Es a través de esta identificación se realiza para medir el rendimiento de su aplicación.
Todos los servicios utilizando la tecnología REST para el tratamiento de las solicitudes. De esta manera usted puede construir fácilmente una dirección URL para ejecutarse en su navegador, línea de comandos o el código.
La URL está constituida de la siguiente manera:
Dónde:
- Nombre de host: URL principal del servicio web
- ServiceName: nombre del servicio
- applicationID: applicationID
- countryCode: Código del país
- Parámetros: Parámetros de servicio
El formato por defecto de la respuesta está en XML, pero existe la opción de utilizar JSON, que a su vez ayuda a la integración de la tecnología con JavaScript y Flash fácilmente y extremadamente ágil.
Formato de Solicitud
El REST es la única tecnología utilizada en todos los servicios de la API Buscapé en el tratamiento de las solicitudes.
Información general
El Transferência de Estado Representacional (Representational State Transfer) o REST es sólo una técnica de ingeniería de software para sistemas distribuidos, que describe una interfaz web simple que utiliza XML, HTTP, JSON o texto sin formato, sin abstracciones adicionales de los protocolos basados en estándares para el intercambio de mensajes como SOAP.
Ejemplo de solicitud utilizando REST
En la URL anterior se utilizó el servicio de Buscapé findProductList API, que permite realizar búsquedas a través de una lista de los productos hasta el final de la ID de clase y / o un conjunto de palabras clave. Application_id: el término se refiere a la identificación de su solicitud de registro de solicitudes de la API de Buscapé y la palabra clave parámetro es la palabra clave de búsqueda entre los productos.
A través de esta solicitud de URL, la API devuelve un XML al Buscapé con una lista de productos con la palabra clave utilizada.
Formatos de Retorno
Usted puede utilizar XML y / o formatos como JSON API para retornar al Buscapé.
API para retornar al Buscapé.
XML (eXtensible Markup Language) es el lenguaje de marcado estándar API en Buscapé, porque con ella el desarrollador puede manejar los datos, independientemente del lenguaje de programación. También tenemos la opción de usar JSON ( JavaScript Object Notation) que es un subconjunto de la anotación de objetos JavaScript, pero su uso por sí solo no requiere JavaScript.
Ejemplo de rendimiento en formato XML
Gracias al servicio de findProductList Buscapé API, busque una lista de los 77 productos de esa categoría que se relaciona con los teléfonos celulares.
Con esa solicitud, el XML se devuelve la siguiente:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
564771466d477a4458664d3d
1.0.0.0
http://bws-apps.buscape.com/mobile/update
2010-10-19T14:09:05.997
2
success
0
success
Celular e Smartphone
LG GT350 Cookie Messenger GSM Desbloqueado
LG GT350 Cookie Messenger Desbloqueado
399.00
399.00
36
8.4
-
3.15 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
GPRS
Micro-USB
WAP
LG GS290 Cookie Plus GSM Desbloqueado
LG GS290 Cookie Plus Desbloqueado
299.99
722.58
14
9.0
-
2.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
LG GX200 GSM Desbloqueado
LG GX200 Desbloqueado
289.00
429.00
74
7.2
-
1.3 MP
-
Dual Chip
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
Fone de Ouvido
GPRS
USB
WAP
Samsung Corby S3650 GSM Desbloqueado
Samsung Corby S3650 Desbloqueado
349.00
818.98
49
8.8
-
2.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Samsung B7320 GSM Desbloqueado
Samsung B7320 Desbloqueado
649.00
939.00
8
6.0
-
3.15 MP
-
Comando de Voz
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Videoconferência
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Wi-Fi
Nokia X3 GSM Desbloqueado
Nokia X3 Desbloqueado
379.00
661.50
20
9.0
-
3.2 MP
-
Comando de Voz
Grava Video
Gravador de Voz
Java
Media Player
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
Micro-USB
WAP
Samsung S5620 Star 3G GSM Desbloqueado
Samsung S5620 Star 3G Desbloqueado
499.99
818.98
19
8.8
-
3.2 MP
-
Grava Video
Gravador de Voz
Java
Media Player
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Wi-Fi
Samsung B5722 GSM Desbloqueado
Samsung B5722 Desbloqueado
605.00
799.00
11
9.4
-
3.15 MP
-
Dual Chip
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
GPRS
USB
WAP
LG GM600 GSM Desbloqueado
LG GM600 Desbloqueado
439.00
738.24
49
8.2
-
3.2 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
TV
Viva Voz
-
Sim
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Nokia E63 GSM Desbloqueado
Nokia E63 Desbloqueado
497.00
1399.00
24
8.6
-
2.0 MP
-
Comando de Voz
Grava Video
Gravador de Voz
Java
Loja Online de Aplicativos
Media Player
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
Micro-USB
WAP
Wi-Fi
Motorola i776 Iden Nextel
Motorola i776 Nextel
290.00
499.00
17
7.6
-
0.3 MP
-
Comando de Voz
Java
LG GX500 GSM Desbloqueado
LG GX500 Desbloqueado
623.00
829.00
14
8.4
-
3.2 MP
-
Dual Chip
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
Micro-USB
WAP
Wi-Fi
Samsung C3300 GSM Desbloqueado
Samsung C3300 Desbloqueado
299.00
379.00
4
9.0
-
1.3 MP
-
Grava Video
Java
Media Player
MP3 Player
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
GPRS
WAP
Samsung B7300 Omnia Lite GSM Desbloqueado
Samsung B7300 Omnia Lite Desbloqueado
799.99
1459.90
3
10.0
-
3.15 MP
-
Grava Video
Gravador de Voz
Java
Media Player
MP3 Player
Rádio
Reproduz Video
Videoconferência
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
GPRS
Micro-USB
Wi-Fi
LG Cookie KP570 GSM Desbloqueado
LG Cookie KP570 Desbloqueado
310.00
699.00
419
9.0
-
3.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Não
-
MicroSD
-
Bluetooth
Fone de Ouvido
USB
WAP
Samsung Star S5230 GSM Desbloqueado
Samsung Star S5230 Desbloqueado
399.00
799.90
127
8.8
-
3.2 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Não
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Ejemplo: Retornar formato JSON
Para utilizar JSON como un método de devolución de su aplicación, debe utilizar el formato de parámetro &format=json decirle al servicio web para devolver el formato solicitado.
También es posible que, en formato JSON, proporcione el nombre de una función de JavaScript para funcionar como una respuesta del servicio web.
El parámetro &callBack=_cb dice al servicio web para retornar _cb("respuesta json"). Utilizar este parámetro no requiere que el desarrollador utilice la función eval("respuesta json") para generar el objeto de JavaScript. Con esto, el desarrollador evita los problemas de seguridad relacionados con el uso de eval() si el contenido de la respuesta no es confiable.
A la continuación se muestra una representación gráfica de una aplicación que utiliza la función de devolución de llamada JSON:
- HTML ejecuta el javascript.
- JavaScript hace una solicitud de servicio de lista de categorías.
- Servicio recibe la petición y busca en la lista de las categorías del Shuffle.
- Servicio recibe la petición y busca en la lista de las categorías del Shuffle.
- Javascript realiza la función _cb(obj).
- función _cb(obj) devuelve una tabla HTML con la lista de los nombres de las categorías
Contenido de otros países
Buscapé La API ofrece la opción de devolver el contenido de un determinado país, siempre y cuando sea con el apoyo de la API y del servicio utilizado.
A la continuación se muestra el formato de la solicitud de URL a utilizar:
En lugar de <country_code> poner el código de país que desee. Vea más abajo todos los países con el apoyo de la API.
poner el código de país que desee. Vea más abajo todos los países con el apoyo de la API.
Servicios
-
Lista Categoría
Buscar por categorías una lista de productos u ofertas. -
Lista de productos
Buscar productos por una o varias palabras o ID de la categoría. -
Lista de ofertas
Buscar todas las ofertas de un determinado producto, filtrando por evaluación de la tienda, el precio o popularidad. -
Lista de productos populares
Buscar los productos más populares de Buscapé -
Calificación del usuario
Buscar las evaluaciones de los usuarios acerca un producto en particular. -
Los detalles técnicos de un producto
Encuentre los detalles técnicos acerca de un producto en particular. -
Los detalles de una tienda o empresa
Buscar contactos y direcciones para una tienda o empresa específica.
Información importante
- El uso de UTF-8 es para que los acentos se muestren correctamente.
- Para mayor seguridad y rendimiento, todas las aplicaciones están limitadas a 2.000 consultas por IP en un período de 24 horas.
API Kit/Wrapper
Vea nuestro Vea nuestro Kit de desarrollo para PHP y .NET para ayudar a integrar sus aplicaciones con el API de Buscapé.
