Días internacionales. API

Esta API acompaña el servicio Días internacionales, una iniciativa del Idescat con motivo del Año Internacional de la Estadística 2013. Esta API proporciona la misma información que el widget de Días internacionales. La vigencia de esta API está ligada a la existencia del mencionado servicio.

Por esta razón, esta API no forma parte de la infraestructura de API del Idescat ni sigue los criterios generales del resto de API.

La utilización de este servicio conlleva la aceptación de las condiciones de uso de las API del Idescat.

Esta API solo estuvo activa en 2013.

Resumen
URI base	http://www.idescat.cat/diades.{format}
Método HTTP	GET
Formatos de la respuesta	json, php
Versión	1.00 (15/02/2013)

1. Petición
2. Respuesta

1. Petición

Las peticiones no incluyen la versión ni admiten operaciones. Esta API solamente soporta dos formatos (JSON y PHP serializado) y un parámetro general (lang —idioma—) con dos posibles valores (ca —catalán, valor por defecto— y es —castellano—). Cuando el formato es JSON, también admite un parámetro callback.

Ej. 1: Petición de información en catalán y en formato JSON

http://www.idescat.cat/diades.json

Ej. 2: Petición de información en castellano y en formato PHP serializado

http://www.idescat.cat/diades.php?lang=es

2. Respuesta

Esta API devuelve respuestas codificadas en UTF-8 en dos posibles formatos: JSON y PHP serializado.

Los elementos de la respuesta son los siguientes:

dist: Distancia en días hasta el próximo día internacional. Se computa teniendo en cuenta la hora local del servidor del Idescat (zona horaria CET). Es siempre un valor positivo o cero.
date: Fecha en formato AAAA-MM-DD del día internacional al que hace referencia dist.
event:
- full: Versión completa de la denominación del día internacional al que hace referencia dist, en el idioma solicitado.
- short: Versión breve de la denominación del día internacional al que hace referencia dist, en el idioma solicitado.
day: Literal (día y mes) del día de celebración del día internacional al que hace referencia dist, en el idioma solicitado.
text: Breve comentario estadístico relacionado con el día internacional al que hace referencia dist, en el idioma solicitado.
link: Dirección de la página dedicada al día internacional al que hace referencia dist, en el idioma solicitado.
img:
- 160x160: Dirección de una imagen pequeña (160x160) para ilustrar el día internacional al que hace referencia dist.
- 740x500: Dirección de una imagen grande (740x500) para ilustrar el día internacional al que hace referencia dist, en el idioma solicitado.

Ej. 3: Ejemplo de salida en formato JSON

{
   "dist": 10,
   "date": "2013-02-21",
   "event": {
      "full": "Día Internacional de la Lengua Materna",
      "short": "Día de la Lengua Materna"
   },
   "day": "21 de febrero",
   "text": "El catalán es la lengua de identificación mayoritaria en cinco de los siete ámbitos territoriales de Cataluña.",
   "link": "http://www.idescat.cat/diades/?id=20130221&amp;lang=es",
   "img": {
      "160x160": "http://www.idescat.cat/diades/img/p20130221.png",
      "740x500": "http://www.idescat.cat/diades/img/g20130221es.png"
   }
}