Días internacionales. API RSS

28.06.2017

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)
Widgets que utilizan este servicio Días internacionales

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&lang=es",
   "img": {
      "160x160": "http://www.idescat.cat/diades/img/p20130221.png",
      "740x500": "http://www.idescat.cat/diades/img/g20130221es.png"
   }
}

Usted está aquí: