Idescat > Developers Area > API > International days

International days. API RSS

Terms of use
15.02.2013

(This text is not available in English.)

Aquesta API acompanya el servei Diades internacionals, una iniciativa de l'Idescat amb motiu de l'Any Internacional de l'Estadística 2013. Aquesta API proporciona la mateixa informació que el giny de Diades internacionals. La vigčncia d'aquesta API estŕ lligada a l'existčncia de l'esmentat servei.

Per aquesta raó, aquesta API no forma part de la infraestructura d'APIs de l'Idescat ni segueix els criteris generals de la resta d'APIs.

La utilització d'aquest servei comporta l'acceptació de les condicions d'ús de les APIs de l'Idescat.

Summary
URI base http://www.idescat.cat/diades.{format}
HTTP Method GET
Response Formats json, php
Version 1.00 (15.02.2013)
Widgets that use this service Internacional days

1. Petició

Les peticions no inclouen la versió ni admeten operacions. Aquesta API només suporta dos formats (JSON i PHP serialitzat) i un parŕmetre general (lang —idioma—) amb dos possibles valors (ca —catalŕ, valor per defecte— i es —castellŕ—). Quan el format és JSON, també admet un parŕmetre callback.

Ex. 1: Petició d'informació en catalŕ i en format JSON
http://www.idescat.cat/diades.json
Ex. 2: Petició d'informació en castellŕ i en format PHP serialitzat
http://www.idescat.cat/diades.php?lang=es

2. Resposta

Aquesta API retorna respostes codificades en UTF-8 en dos possibles formats: JSON i PHP serialitzat.

Els elements de la resposta són els següents:

  • dist: Distŕncia en dies fins a la propera diada internacional. Es computa tenint en compte l'hora local del servidor de l'Idescat (zona horŕria CET). És sempre un valor positiu o zero.
  • date: Data en format AAAA-MM-DD de la diada internacional a la qual fa referčncia dist.
  • event:
    • full: Versió completa de la denominació de la diada internacional a la qual fa referčncia dist, en l'idioma sol·licitat.
    • short: Versió breu de la denominació de la diada internacional a la qual fa referčncia dist, en l'idioma sol·licitat.
  • day: Literal (dia i mes) del dia de celebració de la diada internacional a la qual fa referčncia dist, en l'idioma sol·licitat.
  • text: Breu comentari estadístic relacionat amb la diada internacional a la qual fa referčncia dist, en l'idioma sol·licitat.
  • link: Adreça de la pŕgina dedicada a la diada internacional a la qual fa referčncia dist, en l'idioma sol·licitat.
  • img:
    • 160x160: Adreça d'una imatge petita (160x160) per il·lustrar la diada internacional a la qual fa referčncia dist.
    • 740x500: Adreça d'una imatge gran (740x500) per il·lustrar la diada internacional a la qual fa referčncia dist, en l'idioma sol·licitat.
Ex. 3: Exemple de sortida en format JSON
{
   "dist": 10,
   "date": "2013-02-21",
   "event": {
      "full": "Dia Internacional de la Llengua Materna",
      "short": "Dia de la Llengua Materna"
   },
   "day": "21 de febrer",
   "text": "El catalŕ és la llengua d'identificació majoritŕria en cinc dels set ŕmbits territorials de Catalunya.",
   "link": "http://www.idescat.cat/diades/?id=20130221",
   "img": {
      "160x160": "http://www.idescat.cat/diades/img/p20130221.png",
      "740x500": "http://www.idescat.cat/diades/img/g20130221ca.png"
   }
}
02.15.2013