El País ha lanzado una API con la que podemos conocer todos los datos de la lotería de Navidad en tiempo real, lo que nos permite crear cualquier aplicación con ella, ya que su funcionamiento es muy sencillo y la API nos contesta con JSON.
Y voy a aprovechar para agradecerle a Juan Francisco Cantero que nos haya comentado la existencia de esta API tan útil en estas fechas, y además ha creado un pequeño script en Python con el que se muestra su funcionamiento, primero el script nos devuelve el estado del sorteo y si hemos ganado algo en alguno de nuestros números (que hemos introducido en un archivo de texto).
Funcionamiento de la API de la lotería de Navidad y del Niño
Realmente nos encontramos con dos APIs, la de la lotería de Navidad y la del Niño, que funcionan exactamente igual solo que la ruta de acceso son distintas.
Lotería de Navidad
http://api.elpais.com/ws/LoteriaNavidadPremiadosLotería del Niño
http://api.elpais.com/ws/LoteriaNinoPremiados
Para interactuar con la API solo tenemos que pesarle unos parámetros con el método GET (por ejemplo ?n=99999), que son los siguientes:
-
s(status): tenemos que darle el valor 1 y nos devolverá el estado del sorteo. -
t(timestamp): tenemos que pasarle el valor 1 y nos devuelve la fecha desde la última actualización (tiempo de Unix). -
n(Número consultado): esta función admite dos valores, le podemos pasar el número específico (del 0 al 99999) y nos devolverá la cuantía del premio o pasarle el valor “resumen“ y nos devolverá la lista de los premios más importantes.
Respuesta de la API
Como ya he comentado la API nos contesta objetos JSON, que la mayoría de los lenguajes modernos interpretan sin ningún problema y estas son las respuestas según la función que usemos.
Estado del sorteo
Esto es algo que debemos de tener en cuenta, ya que nos indica la fiabilidad de los datos y si están todos los números ya listados y verificados. La petición sería la siguiente:
http://api.elpais.com/ws/LoteriaNavidadPremiados?s=1Y la respuesta (de antes de empezar el sorteo):
info={"status":0,"error":0}Nota: "error":0 significa que no hay errores, si se produjese alguno (por escribir mal la petición) devolvería 1.
En cuanto a el número de estado tenemos distintos según el estado del sorteo:
-
0: el sorteo no ha comenzado aún. -
1: sorteo empezado, pero no están todos los números (y se actualizan según salen). -
2: el sorteo ha terminado y la lista es provisional. -
3: el sorteo ha terminado y es la lista semioficial. -
4: el sorteo ha terminado y la lista es la oficial.
Resumen de números premiados
Como he comentado podemos conseguir la información de un número individual o de los premios mayores y empezaremos con el resumen de los mayores.
http://api.elpais.com/ws/LoteriaNavidadPremiados?n=resumenY esta sería una simulación de un resultado:
premios={
'timestamp':1292608331,
'status':1, //Estado del sorteo
'numero1':99999, //Premio gordo
'numero2':99998,
'numero3':99947,
'numero4':99941,
'numero5':99942,
'numero6':99951,
'numero7':99952,
'numero8':99953,
'numero9':99954,
'numero10':99955,
'numero11':99956,
'numero12':99957,
'numero13':99958,
'fraseSorteoPDF':'',
'fraseListaPDF':'', //Ruta a la lista en PDF (si está)
'listaPDF':'',
'error':0
}Comprobar premio por número
Para comprobar el premio de un número específico debemos de pasarlo por el parámetro n.
http://api.elpais.com/ws/LoteriaNavidadPremiados?n=99999Y la respuesta sería la siguiente (si no estuviese premiado):
busqueda={
"numero":99999, //Número
"premio":0, //Cuantía del premio
"timestamp":1355831503,
"status":1,
"error":0
}Resumen
Con esta API podemos crear aplicaciones improvisadas que nos retransmitan en tiempo real los resultados de la lotería de Navidad y del Niño, pero desde la documentación de la API nos piden que si vamos a generar muchas peticiones (por ejemplo distribuimos una aplicación) que se lo digamos previamente, sino se reservan el derecho de cortar las conexiones a la APP.
Vía | juanfra684 – Bitbucket
Más información | API – Lotería de Navidad y API – Lotería del Niño
