Selecciona Edición
Selecciona Edición
Tamaño letra

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:

<número> número del que se desea consultar si fue premiado o no. Debe pasarse un número entero entre 0 y 84999, 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: https://api.elpais.com/ws/LoteriaNavidadPremiados?n=7

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}
timestamp: fecha POSIX de la actualización.
status: estado del sorteo (ver arriba).
numero1: gordo del sorteo o -1 si aún no ha salido.
numero2: segundo premio o -1 si aún no ha salido.
numero3: tercer premio o -1 si aún no ha salido.
numero4: primer cuarto del sorteo o -1 si aún no ha salido.
numero5: segundo cuarto del sorteo o -1 si aún no ha salido.
numero6: primer quinto del sorteo o -1 si aún no ha salido.
numero7: segundo quinto del sorteo o -1 si aún no ha salido.
numero8: tercer quinto del sorteo o -1 si aún no ha salido.
numero9: cuarto quinto del sorteo o -1 si aún no ha salido.
numero10: quinto quinto del sorteo o -1 si aún no ha salido.
numero11: sexto quinto del sorteo o -1 si aún no ha salido.
numero12: septimo quinto del sorteo o -1 si aún no ha salido.
numero13: octavo quinto del sorteo o -1 si aún no ha salido.
fraseSorteoPDF: uso interno, descartar.
fraseListaPDF: uso interno, descartar.
listaPDF: enlace a la lista oficial en PDF, vacío si aún no existe enlace.
urlAudio: enlace a la página con en audio de la retransmisión en directo.
error: cero, por tanto, todo ha ido correctamente.
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:

  1. 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.
  2. 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.
  3. Si realmente usas nuestro API, nos gustaría saberlo.

v.2014122001