API para la consulta de premios de la Loteria de Navidad
En EL PAÍS queremos que puedas empezar a desarrollar tus propias aplicaciones con nuestros datos. Desde hace unos meses, tienes el API de Eskup disponible para que puedas acceder a toda la potencia de Eskup desde tu aplicación. Ahora, liberamos un API para que consultes los premios del Sorteo de la Lotería de Navidad. De la misma forma, la Lotería del Niño también dispone de su propio API, (ver documentación del API).
Formato de la petición:
https://api.elpais.com/ws/LoteriaNavidadPremiados
Parámetros:
Sólo se puede pasar uno de los tres siguiente parámetros. Si se pasan varios, sólo se contestará a uno de ellos.
s |
||||
|---|---|---|---|---|
| status | ||||
| (estado del sorteo). El parámetro pasado sólo puede tomar el valor 1 y, en la contestación, se informará de la fase en la que se está en el sorteo. | ||||
t |
||||
| timestamp | ||||
| (fecha POSIX) de la última actualización. | ||||
n |
||||
| Número consultado | ||||
Posibles valores:
|
Estado del Sorteo:
Es muy importante que tengas en cuenta los posibles estados del Sorteo porque son clave para interpretar correctamente la respuesta.
0 |
El sorteo no ha comenzado aún. Todos los números aparecerán como no premiados. | |
|---|---|---|
1 |
El sorteo ha empezado. La lista de números premiados se va cargando poco a poco. Un número premiado podría llegar a tardar unos minutos en aparecer. | |
2 |
El sorteo ha terminado y la lista de números y premios debería ser la correcta aunque, tomada al oído, no podemos estar seguros de ella. | |
3 |
El sorteo ha terminado y existe una lista oficial en PDF. | |
4 |
El sorteo ha terminado y la lista de números y premios está basada en la oficial. De todas formas, recuerda que la única lista oficial es la que publica la ONLAE y deberías comprobar todos tus números contra ella. | |
Formato de la respuesta (cuando la petición es correcta):
La respuesta siempre será en formato JSON, dependerá del parámetro
al que se conteste y, siempre que el procesamiento sea correcto,
contendrá un 'error':0 entre los campos devueltos:
n=<numero> |
||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Si NÚMERO fue premiado la contestación será:
busqueda={'numero':NUMERO,'premio':PREMIO_AL_DECIMO,'timestamp':TS_ACTUALIZACION,'status':ESTADO_DEL_SORTEO,'error':0}
Si el NÚMERO no fue premiado:
busqueda={'numero':NUMERO,'premio':0,'timestamp':TS_ACTUALIZACION,'status':ESTADO_DEL_SORTEO,'error':0}
Un ejemplo de petición sería: |
||||||||||||||||||||||||||||||||||||||||
n=resumen |
||||||||||||||||||||||||||||||||||||||||
premios={'timestamp':1292608331,'status':1,'numero1':10,'numero2':20,'numero3':30,'numero4':41,
'numero5':42,'numero6':51,'numero7':52,'numero8':53,'numero9':54,'numero10':55,'numero11':56,
'numero12':57,'numero13':58,'fraseSorteoPDF':'','fraseListaPDF':'','listaPDF':'','urlAudio':'','error':0}
|
||||||||||||||||||||||||||||||||||||||||
t=1 |
||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||
s=1 |
||||||||||||||||||||||||||||||||||||||||
status son los indicados en el apartado estado del sorteo |
Formato de la respuesta (cuando la petición es incorrecta):
Cuando en el procesamiento de la petición y/o respuesta se produce un error, se contestará un simple:
busqueda={'error':1}Advertencias:
- Como ya hemos dicho varias veces, la única lista oficial es la de la ONLAE. Aunque en EL PAÍS hacemos todos los esfuerzos para devolver resultados correctos, no podemos hacernos responsables de la exactitud de los mismos.
- Sé cortés y educado con el uso del API. Si vas a hacer miles y miles de conexiones, dínoslo. En caso contrario, es más que probable que te cortemos el acceso.
- Si realmente usas nuestro API, nos gustaría saberlo.
v.2014122001