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:

`<número>`	número del que se desea consultar si fue premiado o no. Debe pasarse un número entero entre 0 y 99999, sin ceros a la izquierda y sin puntos.
`resumen`	el literal "resumen" (sin comillas), dará la lista de los principales números premiados (gordo, segundo, tercero, etc.)

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: http://api.elpais.com/ws/LoteriaNinoPremiados?n=7

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]
}

`timestamp`:	fecha POSIX de la actualización.
`status`:	estado del sorteo (ver arriba).
`fraseTexto`:	uso interno, descartar.
`pdfURL`:	enlace a la lista oficial en PDF, vacío si aún no existe enlace.
`error`:	cero, por tanto, todo ha ido correctamente.
`premio1`:	1er. premio del sorteo o -1 si aún no ha salido.
`premio2`:	segundo premio o -1 si aún no ha salido.
`numero3`:	tercer premio o -1 si aún no ha salido.
`extracciones5cifras`:	array con las 12 extracciones de 5 cifras o -1 si aún no ha salido.
`extracciones3cifras`:	array con las 14 extracciones de 3 cifras o -1 si aún no ha salido.
`extracciones2cifras`:	array con las 5 extracciones de 2 cifras o -1 si aún no ha salido.
`reintegros`:	array con los 3 reintegros (2 extracciones especiales + última cifra del 1er. premio) o -1 si aún no ha salido.

t=1

info={'timestamp':1292608331,'error':0}

s=1

info={'status':1,'error':0}

Los posibles valores de 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.2011010201