API para la consulta de premios de la Lotería del Niño
Al igual que hicimos con la Lotería de Navidad (ver documentación del API), la Lotería del Niño también dispone de su propio API. Con él podrás ver los principales números premiados y consultar qué número fue premiado y cual no.
Formato de la petición:
http://api.elpais.com/ws/LoteriaNinoPremiados
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': 1234567890,
'status': 4,
'fraseTexto': 'Esta es la frase',
'pdfURL': 'http://la.url.com/algun/path/',
'error': 0,
'premio1': 79250,
'premio2': 147,
'premio3': 548,
'extracciones4cifras': ['0001', '0002'],
'extracciones3cifras': ['001', '012', '123', '234', '345', '456',
'567', '678', '789', '890', '901', '654', '543', '-1'],
'extracciones2cifras': ['11', '22', '33', '44', '55'],
'reintegros': [0, 1, 3]
}
|
||||||||||||||||||||||||
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.201501051440