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.
http://api.elpais.com/ws/LoteriaNinoPremiados
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:
|
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. |
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, 'extracciones5cifras': ['12345', '23456', '34567', '45678', '56789', '67890', '78901', '89012', '90123', '01234', '-1', '-1'], '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 |
Los posibles valores de status son los indicados en el apartado estado del sorteo |
Cuando en el procesamiento de la petición y/o respuesta se produce un error, se contestará un simple:
busqueda={'error':1}
v.2011010201