API

API RESTful no oficial para consultas en Nic.ar

Se trata de un desarrollo extraoficial, o sea que no fue hecho por quienes manejan Nic.ar, pero que al menos por el momento funciona correctamente. No permite realizar tramites todavía, solo consultas, pero no descartan que en el futuro se añada esa posibilidad.

Para los que no saben, lo que hace una API de estas características es recibir consultas HTTP (requests) y devolver los resultados en XML o JSON, particularmente ésta implementacion funciona con la segunda opción.

Consultas a la API de Nic.ar

En el sitio están muy bien documentadas todas las consultas que pueden realizarse, así como también el formato de los resultados de las mismas.

Si quieren probarlos no necesitan nada más que su navegador, copian las URL desde la documentación y las pegan en su navegador y podrán ver el contenido de la respuesta, si además quieren ver el encabezado pueden usar el Inspector del Chrome o Firebug si están en Firefox.

Pueden visitar el sitio aquí.

Primeros pasos con la API de MercadoLibre

Hace bastante MELI introdujo una nueva API REST que devuelve los resultados en JSON, lo que la hace bastante mejor que la anterior que funcionaba con XML, al menos para mi gusto.

Ahora vamos a ver algunas llamadas básicas para comenzar a comprender como funciona y luego realizar una pequeña tienda utilizando CodeIgniter (PHP).

La API cuenta con llamadas publicas y privadas, para las primeras no necesitamos estar logueados en MELI (no se necesita cuenta), en el caso de las privadas si necesitamos estar logueado, ya que las llamadas permiten acceder a datos del usuario.

En algunas de las llamadas se debe añadir como parámetro el sitio de MercadoLibre del que se quieren obtener los resultados, pueden ver un listado en la siguiente dirección.

https://api.mercadolibre.com/sites/

Llamadas publicas

Una de las llamadas publicas permite realizar búsquedas, la URL a la que se debe realizar es la siguiente, observen que el tercer segmento de la URL incluye el sitio de MercadoLibre del que se quieren obtener los resultados, MLA corresponde a MercadoLibre Argentina.

https://api.mercadolibre.com/sites/MLA/search?q=NOMBRE DEL PRODUCTO

El nombre del producto, la query, no permite espacios (en PHP), por lo tanto si se trata de un producto compuesto por varias palabras se deben reemplazar los espacios por signos más (+), aunque si la llamada la hacemos directamente desde el navegador este se encarga automáticamente de hacerlo, por lo tanto la URL quedaría así.

https://api.mercadolibre.com/sites/MLA/search?q=NOMBRE+DEL+PRODUCTO

Si prueban de ingresar la URL en el navegador verán que pueden ver lo que devuelve la API, aunque de manera “reducida”, para ver la respuesta completa deben hacer clic en el botón que dice “expand all”.

Además, los resultado en la parte derecha muestra información sobre el resultado de la llamada realizada, la “API description” es una descripción breve del contenido que devuelve la API, uno de los mas importantes es el campo “Attributes” que nos describe cada uno de los atributos del objeto JSON devuelto. En “Allowed methods” podemos encontrarnos con distintas opciones para realizar llamadas a la misma API para obtener resultados mas específicos, mediante el agregado de parámetros. En “Related resources” nos encontramos con llamadas que están relacionadas con la cual realizamos.

En los próximos posts hablaremos sobre el tema de aplicación de filtros para las búsquedas y otras llamadas, mientras tanto pueden acceder a mercadolibre.io para investigar por su cuenta.

Otros posts sobre la API de MELI.

Filtrar búsquedas en la API de MercadoLibre

Nueva API de MercadoLibre

Hace mucho tiempo que se pedía que MercadoLibre desarrolle una API para realizar consultas a la pagina de manera mas sencilla, a que hasta hace un tiempo solo teníamos XML y dolor de cabeza, ahora por suerte la gente de MELI está avanzando con la nueva API que funciona con JSON  y que, a mi parecer, hace las cosas mas sencillas.

Pueden ver ejemplos de código en ar.mercadolibre.io, además hay un poco de documentación, yo por mi parte del dejo un ejemplo que comente para que vean, lo comente como para entender bien como funcionaba todo, si tienen dudas pueden consultarme no tengo problemas, perdón por el lenguaje pero en principio lo había comentado para mi entendimiento y el de un amigo simplemente.

Hoy mientras hacia mi recorrido diario por Reddit encontré algo sobre una función de Google Maps llamada “My Location”, me puse a buscar un poquito mas para ver de que se trataba y descubrí que en realidad es una funcionalidad que tiene mas de un año, y fue pensada para dispositivos móviles que tengan GPS, en los que encontrar la localización exacta es pan comido. Lo que verdaderamente me sorprendió es que probandolo desde mi notebook que no tiene GPS, Google me encontró! la primera vez que probé situó el marcador justo sobre el lugar donde me encuentro, eso me intrigó y comencé a buscar como hacia para tener tamaña exactitud.

My Location y W3C Geolocation API

Google se vale de la API del W3C para intentar establecer nuestra ubicación, cuando activamos el servicio nuestro navegador intenta determinar si hay Access Points alrededor para estimar nuestra ubicación, en caso de no encontrar ninguno, ya sea porque no hay ninguno en nuestro radio o porque nuestra PC no tiene WiFi, la locación se intenta determinar utilizando la IP de nuestra PC, lo que hace que la exactitud se pierda por completo.

Prueba con WiFi activado vs Wifi desactivado

Para demostrar que la precisión del servicio dependia de primero con la placa de red inalambrica activada probé cual era la ubicación que me brindaba el servicio, y luego hice otra prueba deshabilitando la placa de red inalambrica y conectado a través de un cable Ethernet, y los resultados se corresponden a lo que dije anteriormente.



Con WiFi activado

Ésta es la ubicación que me da Google con el WiFi activado

Con WiFi desactivado

Ésta es la ubicación que me da Google con el WiFi desactivado

En las imágenes se nota claramente que el servicio funciona mucho mejor al tener a nuestro alcance algunos Access Points.

Una cosa que no les comente es que para probar “My Location” deben ingresar a Google Maps y sobre el icono que activa Street View (la personita naranja), hay un pequeño botoncito blanco, cuando activan el servicio se vuelve azul. Una observación es que necesitan tener Google Chrome 2.0+ o Mozilla Firefox 3.5+, y en IE deben instalar la barra de herramientas de Google.