Idescat. 脌rea de desenvolupadors. API. Indicadors al dia

<!DOCTYPE html>     <html lang="ca">  <head> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta charset="utf-8" />  <link rel="alternate" type="application/rss+xml" title="Idescat. API" href="/api/?f=rss" /> <title>Idescat. 脌rea de desenvolupadors. API. Indicadors al dia</title> <link rel="stylesheet" type="text/css" media="all" href="/estils/std.css" /> <link rel="stylesheet" type="text/css" media="all" href="/estils/doc.css" /> <link rel="preload" as="font" crossorigin type="font/woff" href="/estils/fonts/opensans-regular.woff" /> <link rel="preload" as="font" crossorigin type="font/woff" href="/estils/fonts/opensans-semibold.woff" /> <link rel="preload" as="font" crossorigin type="font/woff" href="/estils/fonts/opensans-bold.woff" /> <link rel="preload" as="image" href="/images/gencat.svg" media="(min-width: 741px)" /> <link rel="preload" as="image" href="/images/mgencat.png" media="(max-width: 740px)" /> <link rel="preload" as="image" href="/images/mlupa.png" /> <link rel="search" type="application/opensearchdescription+xml" href="/xml/opensearch-ca.xml" title="Idescat" /> <link rel="shortcut icon" href="/images/favicon.ico" type="image/x-icon" /> <link rel="icon" sizes="192x192" href="/images/favicon192.png" type="image/png" /> <link rel="apple-touch-icon" sizes="180x180" href="/images/favicon180.png" /> <link rel="apple-touch-icon" sizes="152x152" href="/images/favicon152.png" /> <link rel="apple-touch-icon" sizes="120x120" href="/images/favicon120.png" /> <link rel="alternate" type="application/rss+xml" title="Idescat. Novetats" href="/novetats/?m=rss" /> <script src="/commonScripts/idescat.js"></script> <script src="/commonScripts/cat/idescat.js"></script>  <script async src="https://www.googletagmanager.com/gtag/js?id=G-0Z6NJ7PL6K"></script> <script>IDESCAT.analitica({"seccio":"serveis","tema":"-","estad":"-","prod":"-"});</script> </head> <body>  <noscript><iframe title="Google Tag Manager" src="https://www.googletagmanager.com/ns.html?id=GTM-NH8MVLN" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>  <div id="Contingut"> <a class="WAIocult" href="#Titol">Saltar al contingut principal</a> <header class="ca"> <div class="aplec"> <div id="principal"> <div id="logo"><a href="/" title="Institut d’Estadística de Catalunya (Idescat)">idescat</a></div> <div class="idiomes" role="navigation" aria-label="Idioma de la p脿gina"> <ul><li><a href="?lang=es" title="Esta página está traducida total o parcialmente al castellano" hreflang="es">es</a></li><li><a href="?lang=en" title="This page is totally or partially translated into English" hreflang="en">en</a></li></ul> </div> <div id="logogencat"><a href="//web.gencat.cat/ca/inici/" title="Generalitat de Catalunya">gencat</a></div> </div> <div id="org"><a href="/">Institut d’Estadística de Catalunya</a></div> <nav> <ul> <li id="dades"> <h2><a href="/dades/" aria-haspopup="true" aria-expanded="false" aria-controls="ARIAnavdades">Dades</a></h2> <div id="ARIAnavdades" class="tab"> <div class="aplec"> <div class="grup"> <h3>Demografia i societat</h3> <ul> <li><a href="/tema/xifpo">Població</a></li> <li><a href="/tema/cultu">Cultura · Llengua</a></li> <li><a href="/tema/educa">Educació</a></li> <li><a href="/tema/elecc">Eleccions</a></li> <li><a href="/tema/justi">Justícia · Seguretat</a></li> <li><a href="/tema/salut">Salut</a></li> <li><a href="/tema/treba">Treball</a></li> </ul> <h3>Qualitat de vida</h3> <ul> <li><a href="/tema/cvida">Condicions de vida</a></li> <li><a href="/tema/habit">Habitatges i edificis</a></li> <li><a href="/tema/ingre">Ingressos i consum de les llars</a></li> <li><a href="/tema/proso">Protecció social</a></li> </ul> </div> <div class="grup"> <h3>Economia</h3> <ul> <li><a href="/tema/macro">Macromagnituds</a></li> <li><a href="/tema/empre">Empreses · Finances</a></li> <li><a href="/tema/finan">Finances públiques</a></li> <li><a href="/tema/inver">Inversió i comerç exterior</a></li> <li><a href="/tema/preus">Preus</a></li> <li><a href="/tema/recer">Recerca · Tecnologia</a></li> </ul> <h3>Sectors econòmics</h3> <ul> <li><a href="/tema/agrar">Agricultura · Ramaderia · Pesca</a></li> <li><a href="/tema/comer">Comerç · Serveis</a></li> <li><a href="/tema/const">Construcció</a></li> <li><a href="/tema/indus">Indústria · Energia</a></li> <li><a href="/tema/trans">Transport</a></li> <li><a href="/tema/turis">Turisme</a></li> </ul> <h3>Medi ambient · Territori</h3> <ul> <li><a href="/tema/media">Medi ambient</a></li> <li><a href="/tema/terri">Territori</a></li> </ul> </div> <div class="grup"> <h3>Temes transversals</h3> <ul> <li><a href="/estad/iig">Índex d'igualtat de gènere</a></li> <li><a href="/dades/ods/">Objectius de desenvolupament sostenible</a></li> </ul> <h3>Per àmbit geogràfic</h3> <ul> <li><a href="/estad/?geo=prov">Províncies</a></li> <li><a href="/estad/?geo=at">Àmbits del Pla territorial</a></li> <li><a href="/estad/?geo=mt">Marques tur铆stiques</a></li> <li><a href="/estad/?geo=com">Comarques i Aran</a></li> <li><a href="/estad/?geo=mun">Municipis</a></li> <li><a href="/estad/?geo=ac">Agrupacions censals</a></li> <li><a href="/estad/?geo=ep">Entitats de poblaci贸</a></li> <li><a href="/estad/?geo=dis">Districtes</a></li> <li><a href="/estad/?geo=sec">Seccions censals</a></li> </ul> <h3>Dades b脿siques</h3> <ul> <li><a href="/indicadors/?id=basics">Indicadors bàsics de Catalunya</a></li> <li><a href="/indicadors/?id=ue">Indicadors de la Unió Europea</a></li> <li><a href="/pub/?id=inddt">Indicadors demogràfics i de territori</a></li> <li><a href="/indicadors/?id=aec">Anuari estadístic de Catalunya</a></li> <li><a href="/emex/">El municipi en xifres</a></li> </ul> </div> <div class="peu"><a href="/estad/">Estadístiques A–Z</a> <strong>•</strong> <a href="/cal/">Calendari</a> <strong>•</strong> <a href="/novetats/">Novetats</a> <strong>•</strong> <a href="/dades/encurs/">Enquestes en curs</a> <strong>•</strong> <a href="/dades/obertes/">Dades obertes</a> <strong>•</strong> <a href="/rectificacions/">Rectificacions</a> <strong>•</strong> <a href="/dades/infografies/">Infografies</a></div> </div> </div> </li> <li id="serveis" class="active"> <h2><a href="/serveis/" aria-haspopup="true" aria-expanded="false" aria-controls="ARIAnavserveis">Serveis</a></h2> <div id="ARIAnavserveis" class="tab"> <div class="aplec"> <div class="grup"> <h3>Informació estadística</h3> <ul> <li><a href="/serveis/consultes/">Consultes</a></li> <li><a href="/serveis/certificats/">Certificats</a></li> <li><a href="/serveis/cendoc/">Centre de Documentaci贸</a></li> <li><a href="/serveis/biblioteca/publicacions/">Publicacions de l'Idescat</a></li> <li><a href="/serveis/suggeriments/">Suggeriments</a></li> <li class="abanda"><a href="/serveis/carta/">Carta de serveis</a></li> </ul> </div> <div class="grup"> <h3>Per als mitjans de comunicació</h3> <ul> <li><a href="/serveis/premsa/">Notes de premsa i consultes</a></li> </ul> <h3>Per al sector educatiu</h3> <ul> <li><a href="/serveis/educacio/visites/">Visites a l'Idescat</a></li> <li><a href="/serveis/educacio/sessions/">Sessions monogr脿fiques</a></li> <li><a href="/serveis/educacio/concursos/">Concursos</a></li> </ul> <h3>Per a investigadors</h3> <ul> <li><a href="/serveis/dades/">Dades confidencials</a></li> </ul> <h3>Per a desenvolupadors</h3> <ul> <li><a href="/dev/api/">API</a></li> <li><a href="/dev/visual/">Visual</a></li> </ul> </div> <div class="grup"> <h3>Per al Sistema estadístic de Catalunya</h3> <ul> <li><a href="/formacio/">Formació i activitats</a></li> </ul> <h3>Generals</h3> <ul> <li><a href="/serveis/lloguer/">Lloguer d'espais</a></li> <li><a href="/pagaments/">Pagaments</a></li> </ul> </div> </div> </div> </li> <li id="metodes"> <h2><a href="/metodes/" aria-haspopup="true" aria-expanded="false" aria-controls="ARIAnavmetodes">Mètodes</a></h2> <div id="ARIAnavmetodes" class="tab"> <div class="aplec"> <div class="grup"> <h3>Classificacions i codis</h3> <ul> <li><a href="/metodes/classificacions/">Classificacions estadístiques</a></li> <li><a href="/codis/">Codis territorials i d'entitats</a></li> </ul> </div> <div class="grup"> <h3>Instruments de qualitat</h3> <ul> <li><a href="/cal/">Calendari de difusió de resultats</a></li> <li><a href="/metodes/difusio/">Pol铆tica de difusi贸 de resultats</a></li> <li><a href="/dades/encurs/">Enquestes en curs</a></li> <li><a href="/rectificacions/">Rectificacions</a></li> <li><a href="/metodes/bonespractiques/">Codi de bones pràctiques</a></li> <li><a href="/metodes/siie/">SIIE: Plataforma Cerdà i Qualitas</a></li> <li><a href="/serveis/carta/">Carta de serveis</a></li> </ul> </div> <div class="grup"> <h3>Recerca i innovació</h3> <ul> <li><a href="/sort/">Journal SORT</a></li> <li><a href="/metodes/manifestdades/">Manifest de les dades</a></li> </ul> </div> </div> </div> </li> <li id="institut"> <h2><a href="/institut/" aria-haspopup="true" aria-expanded="false" aria-controls="ARIAnavinstitut">L'Institut</a></h2> <div id="ARIAnavinstitut" class="tab"> <div class="aplec"> <div class="grup"> <h3>L'Institut d'Estadística de Catalunya (Idescat)</h3> <ul> <li><a href="/institut/idescat/">Presentació</a></li> <li><a href="/institut/idescat/organitzacio/">Organització</a></li> <li><a href="/institut/idescat/memoria/">Memòria anual</a></li> <li><a href="/institut/idescat/convenis/">Convenis</a></li> <li><a href="/institut/web/privadesa/">Protecci贸 de dades</a></li> <li><a href="/institut/idescat/transparencia/">Transparència</a></li> <li><a href="/institut/idescat/contractacio/">Perfil del contractant</a></li> <li><a href="/institut/idescat/ofertes/">Ofertes de treball</a></li> <li class="abanda"><a href="/institut/idescat/contacte/">Contacte</a></li> </ul> </div> <div class="grup"> <h3>El Sistema estadístic de Catalunya (SEC)</h3> <ul> <li><a href="/institut/sec/">Presentació</a></li> <li><a href="/institut/sec/crsec/">Consell Rector</a></li> <li><a href="/institut/sec/legislacio/">Legislació</a></li> <li><a href="/pec/">Pla estadístic de Catalunya</a></li> <li><a href="/institut/sec/ciutadans/">Els ciutadans i l'estadística oficial</a></li> <li><a href="/institut/sec/rfe/">Registre de fitxers estadístics</a></li> <li><a href="/institut/sec/extranet/">Extranet del SEC</a></li> </ul> </div> </div> </div> </li> <li id="cercador"> <form method="get" action="/cercador/" accept-charset="UTF-8" role="search"> <label class="WAIocult" for="inputSearch">Cercar</label><input aria-label="Cercar" id="inputSearch" value="" name="q" accesskey="T" type="search" spellcheck="false" /> </form> </li> </ul> </nav> </div> </header> <main> <div id="Titular"><div class="aplec"> <ul id="BarraSituacio"><li><a href="/dev/">脌rea de desenvolupadors</a></li><li><a href="/dev/api/">API</a></li></ul> <h1 id="Titol">Indicadors al dia. <abbr title="Interf铆cie de programaci贸 d'aplicacions">API</abbr> <a href="/api/?f=rss"><img src="/images/rss.png" alt="RSS" title="RSS: API" class="rss" /></a></h1> </div></div> <div class="aplec"><aside class="Promo"> <a class="Boto" id="cdu" href="/dev/api/#cdu">Condicions d'煤s</a> </aside> <div class="Doc"> <div class="Apart Intro"> <div class="ApartCont"> <p>El servei d'Indicadors al dia proporciona informaci贸 b脿sica d'una selecci贸 d'indicadors de Catalunya.</p> <p>La utilitzaci贸 d'aquest servei comporta l'acceptaci贸 de les <a href="/dev/api/#cdu">condicions d'煤s de les APIs de l'Idescat</a>.</p> </div> </div> <div class="ApartD TaulaD"> <table class="ApartD"> <caption>Resum</caption> <tbody class="fil"> <tr> <th scope="row"><abbr title="Identificador uniforme de recurs">URI</abbr> base</th> <td>https://api.idescat.cat/indicadors/v1/{operaci贸}.{format}[?par脿metres]</td> </tr> <tr> <th scope="row">M猫tode HTTP</th> <td>GET</td> </tr> <tr> <th scope="row">Formats de la resposta</th> <td>xml, json, php</td> </tr> <tr> <th scope="row">Versi贸</th> <td>1.00 (14/12/2009)</td> </tr> <tr> <th scope="row">Dreceres</th> <td><a href="#a1">Petici贸</a>, <a href="#a2">Resposta</a>, <a href="#a3">Exemples</a></td> </tr> <tr> <th scope="row">Operacions</th> <td>dades, nodes</td> </tr> </tbody> </table> </div> <div class="Index multinivell"> <div class="Apart"> <div class="ApartContAmbVincles"> <ul> <li><a href="#a1">1. Petici贸</a> <ul> <li><a href="#a1.1">1.1 Anatomia de les peticions</a> <ul> <li><a href="#a1.1.1">1.1.1 Identificador del servei i versi贸</a></li> <li><a href="#a1.1.2">1.1.2 Operacions</a></li> </ul> </li> <li><a href="#a1.2">1.2 Par脿metres espec铆fics</a> <ul> <li><a href="#a1.2.1">1.2.1 Operaci贸 <kbd>dades</kbd></a> <ul> <li><a href="#a1.2.1.1">1.2.1.1 Indicadors predeterminats</a></li> <li><a href="#a1.2.1.2">1.2.1.2 Darrers indicadors</a></li> </ul> </li> <li><a href="#a1.2.2">1.2.2 Operaci贸 <kbd>nodes</kbd></a></li> </ul> </li> </ul> </li> <li><a href="#a2">2. Resposta</a> <ul> <li><a href="#a2.1">2.1 Estructura dels resultats</a> <ul> <li><a href="#a2.1.1">2.1.1 L'element arrel <var>indicadors</var></a></li> <li><a href="#a2.1.2">2.1.2 Els elements <var>i</var> de l'operaci贸 <kbd>dades</kbd></a> <ul> <li><a href="#a2.1.2.1">2.1.2.1 Elements generals</a></li> <li><a href="#a2.1.2.2">2.1.2.2 Elements espec铆fics de l'脿mbit geogr脿fic</a></li> </ul> </li> <li><a href="#a2.1.3">2.1.3 Els elements <var>v</var> de l'operaci贸 <kbd>nodes</kbd></a></li> </ul> </li> <li><a href="#a2.2">2.2 Errors</a> <ul> <li><a href="#a2.2.1">2.2.1 Operaci贸 <kbd>dades</kbd></a></li> <li><a href="#a2.2.2">2.2.2 Operaci贸 <kbd>nodes</kbd></a></li> </ul> </li> </ul> </li> </ul> </div> </div> </div> <div class="Apart"> <h2 id="a1">1. Petici贸</h2> <div class="ApartCont"> <h3 id="a1.1">1.1 Anatomia de les peticions</h3> <p>Tota petici贸 ha d'especificar obligat貌riament el servei, la versi贸, l'operaci贸 i el format. Versi贸 i operaci贸 s贸n caracter铆stiques espec铆fiques de cada servei. Si no es diu el contrari, el servei suporta els formats de resposta generals de les APIs de l'Idescat. Per a m茅s informaci贸, consulteu l'apartat Anatomia de les peticions a la <a href="/dev/api/#a1.1">documentaci贸 general de les APIs de l'Idescat</a>.</p> <h4 id="a1.1.1">1.1.1 Identificador del servei i versi贸</h4> <p>El servei d'Indicadors al dia s'identifica amb el valor <kbd>indicadors</kbd>.</p> <pre class="uri">https://api.idescat.cat/<kbd>indicadors</kbd><wbr />/<kbd>v1</kbd><wbr />/{…}</pre> <h4 id="a1.1.2">1.1.2 Operacions</h4> <p>Admet dos tipus d'operacions:</p> <ul> <li> <kbd>dades</kbd>: Retorna dades en forma de s猫rie temporal per a Catalunya i Espanya de l'indicador al dia escollit. Vegeu la secci贸 <a href="/dev/api/indicadors/#a1.2.1">1.2.1</a>. <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/<kbd>dades</kbd>.{…}</pre> </li> <li> <kbd>nodes</kbd>: Retorna l'arbre dels indicadors disponibles. Vegeu la secci贸 <a href="/dev/api/indicadors/#a1.2.2">1.2.2</a>. <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/<kbd>nodes</kbd>.{…}</pre> </li> </ul> <h3 id="a1.2">1.2 Par脿metres espec铆fics</h3> <p>Els par脿metres espec铆fics ("variables") permeten escollir la informaci贸 que retornar脿 una determinada operaci贸 del servei d'Indicadors al dia. Es poden especificar com a par脿metres individuals o en un 煤nic par脿metre <var>p</var> (<a href="/dev/api/#a1.3.1">forma compacta</a>). En aquesta documentaci贸, s'utilitza sempre la forma compacta.</p> <p>Per con猫ixer els par脿metres generals disponibles per a qualsevol servei, consulteu la <a href="/dev/api/#1.2">documentaci贸 de les APIs de l'Idescat</a>.</p> <h4 id="a1.2.1">1.2.1 Operaci贸 <kbd>dades</kbd></h4> <p>Permet seleccionar un conjunt fix d'indicadors del qual es vol obtenir informaci贸 o b茅 aquells indicadors m茅s recents (siguin els que siguin).</p> <h5 id="a1.2.1.1">1.2.1.1 Indicadors predeterminats</h5> <ul> <li><var>i</var>: llista dels identificadors (separats per comes) dels indicadors dels quals es retornar脿 informaci贸.</li> </ul> <p>Per con猫ixer els identificadors dels diferents indicadors disponibles, utilitzeu l'operaci贸 <kbd><a href="#a1.2.2">nodes</a></kbd>. L'<a href="#e23">exemple 23</a> mostra la llista actual d'indicadors i els seus identificadors.</p> <p>Si aquesta variable de selecci贸 est脿 present (encara que no tingui un valor assignat), s'ignoraran la resta de par脿metres espec铆fics.</p> <h6 id="e1" class="Exemple"><a href="#e1">Ex. 1</a>: S猫ries per a Catalunya i Espanya dels indicadors 0801 i 0802, en format XML</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/dades.xml?<var>p</var>=<kbd>i<wbr />/0801,0802</kbd></pre> <h5 id="a1.2.1.2">1.2.1.2 Darrers indicadors</h5> <p>Permet seleccionar els indicadors d'acord amb la combinaci贸 de tres criteris:</p> <ul> <li><var>tt</var>: temps transcorregut. Permet seleccionar els indicadors d'acord amb els dies transcorreguts des de la seva publicaci贸. El valor <kbd>1</kbd> selecciona els indicadors publicats avui; <kbd>2</kbd> selecciona els indicadors d'avui i ahir; etc. El valor per defecte 茅s <kbd class="defecte">0</kbd> i indica que la selecci贸 d'indicadors no est脿 limitada pel temps transcorregut.</li> <li><var>max</var>: m脿xim nombre d'indicadors. Limita el nombre d'indicadors mostrats, sigui quin sigui el temps transcorregut. El valor <kbd>0</kbd> indica que la selecci贸 d'indicadors no est脿 limitada per un nombre. El valor per defecte 茅s <kbd class="defecte">6</kbd>.</li> <li><var>min</var>: m铆nim nombre d'indicadors. Garanteix que es mostri un nombre m铆nim d'indicadors, sigui quin sigui el temps transcorregut. El valor per defecte 茅s <kbd class="defecte">6</kbd>.</li> </ul> <p>Els indicadors es retornen en ordre inversament cronol貌gic.</p> <h6 id="e2" class="Exemple"><a href="#e2">Ex. 2</a>: Indicadors dels darrers 14 dies (incl貌s avui), per貌 garantint l'obtenci贸 de 3 indicadors i limitant el resultat a un m脿xim de 10, en format XML</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/dades.xml<wbr />?<var>p</var>=<kbd>tt/14<wbr />;max/10<wbr />;min/3</kbd></pre> <h6 id="e3" class="Exemple"><a href="#e3">Ex. 3</a>: Darrers 3 indicadors, en format JSON</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/dades.json<wbr />?<var>p</var>=<kbd>tt/0<wbr />;max/3<wbr />;min/3</kbd></pre> <h6 id="e4" class="Exemple"><a href="#e4">Ex. 4</a>: Indicadors dels darrers 3 dies (incl貌s avui) sense importar el nombre m脿xim ni el m铆nim, en format PHP serialitzat</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/dades.php<wbr />?<var>p</var>=<kbd>tt/3<wbr />;max/0<wbr />;min/0</kbd></pre> <h6 id="e5" class="Exemple"><a href="#e5">Ex. 5</a>: Tots els indicadors existents sense importar el temps transcorregut, en format XML</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/dades.xml<wbr />?<var>p</var>=<kbd>tt/0<wbr />;max/0<wbr />;min/0</kbd></pre> <p><strong>Atenci贸: El temps de resposta d'aquesta petici贸 pot ser significatiu. S'aconsella dimensionar les peticions a les necessitats reals d'informaci贸. En cap cas s'han de sol路licitar tots els indicadors sense mantenir algun tipus de <em>cach茅</em> en la m脿quina sol路licitant.</strong></p> <h4 id="a1.2.2">1.2.2 Operaci贸 <kbd>nodes</kbd></h4> <p>Retorna la llista d'indicadors disponibles, amb el seu identificador i una descripci贸, agrupats en apartats i subapartats. El par脿metre <var>i</var> permet filtrar els apartats que es mostren.</p> <ul> <li><var>i</var>: llista dels identificadors (separats per comes) dels apartats dels quals es retornar脿 informaci贸. Si no s'especifica, es mostraran tots els apartats.</li> </ul> <p>Per con猫ixer els identificadors dels apartats disponibles actualment, utilitzeu l'operaci贸 <kbd>nodes</kbd> sense especificar <var>i</var>.</p> <h6 id="e6" class="Exemple"><a href="#e6">Ex. 6</a>: Arbre de tots els indicadors disponibles, en format JSON amb funci贸 de devoluci贸 ("func")</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/nodes.json?<var>callback</var>=<kbd>func</kbd></pre> <h6 id="e7" class="Exemple"><a href="#e7">Ex. 7</a>: Arbre dels Indicadors b脿sics de Catalunya (2), en format XML</h6> <pre class="uri">https://api.idescat.cat/indicadors<wbr />/v1<wbr />/nodes.xml<wbr />?<var>p</var>=<kbd>i/2</kbd></pre> </div> </div> <div class="Apart"> <h2 id="a2">2. Resposta</h2> <div class="ApartCont"> <p>Per con猫ixer els <strong class="important">codis de resposta</strong> <abbr title="HyperText Transfer Protocol">HTTP</abbr> retornats i els <strong class="important">formats suportats</strong> per qualsevol servei, consulteu l'<a href="/dev/api/#a2">apartat 2 de les APIs de l'Idescat</a>.</p> <h3 id="a2.1">2.1 Estructura dels resultats</h3> <h4 id="a2.1.1">2.1.1 L'element arrel <var>indicadors</var></h4> <p>L'element arrel (<var>indicadors</var>) inclou els seg眉ents atributs:</p> <ul> <li><kbd>version</kbd>: versi贸 del servei.</li> <li><kbd>lang</kbd>: idioma general del document. Si el valor d'algun element textual no utilitza aquest idioma tindr脿 el seu propi atribut <kbd>lang</kbd>. Els valors acceptats en l'actualitat s贸n <kbd class="defecte">ca</kbd> (valor per defecte), <kbd>es</kbd> i <kbd>en</kbd>.</li> <li><kbd>o</kbd>: operaci贸 sol路licitada.</li> <li><kbd>p</kbd>: valors assignats als par脿metres espec铆fics, si n'hi ha.</li> <li><kbd>n</kbd>: nombre d'indicadors o nodes finals amb informaci贸 que s'han incl貌s en el document. Aquest nombre no coincideix amb el nombre d'elements retornats quan d'algun indicador o node final no s'ha obtingut informaci贸 v脿lida.</li> </ul> <h6 id="e8" class="Exemple"><a href="#e8">Ex. 8</a>: Atributs de l'element arrel en una operaci贸 <kbd>dades</kbd></h6> <pre class="codi"><<var>indicadors</var> <kbd>xmlns:dc</kbd>="http://purl.org/dc/elements/1.1/" <kbd>version</kbd>="1.00" <kbd>lang</kbd>="ca" <kbd>o</kbd>="dades" <kbd>n</kbd>="6" <kbd>p</kbd>="tt=0;max=6;min=6;" ></pre> <h6 id="e9" class="Exemple"><a href="#e9">Ex. 9</a>: Atributs de l'element arrel en una operaci贸 <kbd>nodes</kbd></h6> <pre class="codi"><<var>indicadors</var> <kbd>version</kbd>="1.00" <kbd>lang</kbd>="ca" <kbd>o</kbd>="nodes" <kbd>n</kbd>="54" <kbd>p</kbd>="i=2" ></pre> <h4 id="a2.1.2">2.1.2 Els elements <var>i</var> de l'operaci贸 <kbd>dades</kbd></h4> <p>La informaci贸 de cada indicador s'inclou a l'element <var>i</var>. A m茅s de la informaci贸 de Catalunya, podria incloure informaci贸 de comparaci贸 d'un o m茅s 脿mbits geogr脿fics (en l'actualitat, nom茅s d'Espanya).</p> <h6 id="e10" class="Exemple"><a href="#e10">Ex. 10</a>: Element <var>i</var> de l'operaci贸 <kbd>dades</kbd></h6> <pre class="codi"> <i id="0302"> <c>Pernoct. hotels</c> <r title="gen/09">2009-01</r> <d>Variaci贸 interanual de pernoctacions en establiments hotelers</d> <v>-12.0</v> <s>Idescat, a partir de l'Enquesta d'ocupaci贸 hotelera de l'INE</s> <vc g="es">-11.5</vc> <sc g="es">INE</sc> <ts>-1.0,7.9,15.2,-16.6,2.4,-1.2,2.8,1.4,-3.7,-5.6,-10.5,-6.6,-12.0</ts> <tsc g="es">1.2,8.6,9.6,-11.9,6.2,-2.8,0.4,-0.5,-3.2,-5.3,-11.0,-10.6,-11.5</tsc> <u s="%">%</u> <l>https://www.idescat.cat/economia/inec?tc=3&id=0302</l> <m>https://www.idescat.cat/economia/inec?tc=7&id=0302</m> <t i="c">Conjuntura econ貌mica</t> <dc:date>2009-03-04T14:07:00+00:00</dc:date> </i> </pre> <h5 id="a2.1.2.1">2.1.2.1 Elements generals</h5> <p>Els elements generals s贸n:</p> <ul> <li><var>c</var>: concepte. Per exemple, "IPC".</li> <li><var>d</var>: descripci贸 de l'indicador. Per exemple, "Variaci贸 interanual de l'铆ndex de preus de consum".</li> <li><var>r</var>: refer猫ncia temporal. Cont茅 almenys un any (quatre d铆gits). Per exemple, "2009". L'especificaci贸 d'any pot anar seguida d'un gui贸. Si despr茅s del gui贸 hi ha un nombre de dos d铆gits indica mes ("2009-10": octubre del 2009); si nom茅s n'hi ha un, indica trimestre ("2009-3": tercer trimestre del 2009). Altres per铆odes de refer猫ncia s'expressen en forma d'interval (data d'inici i final separades per coma). Per exemple, "2009-01,2009-05" indica el per铆ode gener-maig del 2009. L'element <var>r</var> cont茅 un atribut <kbd>title</kbd> que inclou la refer猫ncia temporal en forma de text breu en l'idioma general <kbd>lang</kbd>. Per exemple: "gen/09".</li> <li><var>u</var>: aquest element s'utilitza per facilitar informaci贸 sobre les unitats de l'indicador. El seu contingut pot proporcionar un text brev铆ssim concatenable al valor. En l'actualitat, nom茅s s'utilitza per passar el s铆mbol "%"; en la resta de casos est脿 en blanc. Aquest element cont茅 un atribut <kbd>s</kbd> que no est脿 plenament desenvolupat en l'actual versi贸 de l'API.</li> <li><var>l</var>: Enlla莽 amb la p脿gina de l'indicador.</li> <li><var>m</var>: Enlla莽 amb la p脿gina de la metodologia de l'indicador (a partir del 24 d'abril de 2018, els indicadors van deixar de tenir una p脿gina espec铆fica sobre la seva metodologia i, com a conseq眉猫ncia, aquest element va deixar de proporcionar-se).</li> <li><var>t</var>: Text descriptiu del tipus d'indicador en l'idioma general <kbd>lang</kbd>. L'atribut <kbd>i</kbd> inclou una versi贸 codificada.</li> <li><var>dc:date</var>: data d'actualitzaci贸 de l'indicador (per exemple, "2009-03-08T11:05:00+00:00"). Vegeu la <a href="http://dublincore.org/" class="extern" target="_blank" rel="noopener" title="Vincle extern: s'obrir脿 una nova finestra">Dublin Core Metadata Initiative</a>.</li> </ul> <h5 id="a2.1.2.2">2.1.2.2 Elements espec铆fics de l'脿mbit geogr脿fic</h5> <p>Indicadors al dia est脿 concebut com un servei que proporciona informaci贸 de Catalunya. Addicionalment, pot oferir la mateixa informaci贸 per a d'altres 脿mbits de comparaci贸. La informaci贸 de Catalunya est脿 continguda en els seg眉ents elements (que sempre estan presents):</p> <ul> <li><strong class="important">Valors</strong> <p>Els elements que contenen valors indiquen els decimals amb punt (per exemple, "10.5"). Els valors faltants s'indiquen amb "_".</p> <ul> <li><var>v</var>: valor del darrer per铆ode disponible. Aquest valor, que tamb茅 es proporciona a l'element <var>ts</var>, s'ofereix a <var>v</var> per conveni猫ncia.</li> <li><var>ts</var>: s猫rie temporal. Els valors de la s猫rie, ordenats de m茅s antic a m茅s recent, van separats per comes. En general, la s猫rie s'inicia en el mateix per铆ode de refer猫ncia de les dades actuals per貌 d'un any enrere. Per tant, si la periodicitat de les dades 茅s mensual, s'inclouen 13 observacions i, si 茅s trimestral, 5. En el cas de valors anuals, s'ofereixen fins a 5 anys (o menys si la s猫rie de dades disponibles 茅s m茅s curta). Si no hi ha una s猫rie temporal disponible, aquest element no estar脿 present.</li> </ul> </li> <li><strong class="important">Textos</strong> <ul> <li><var>s</var>: text que expressa la font de les dades.</li> </ul> </li> </ul> <p>Si hi ha informaci贸 disponible per a d'altres 脿mbits geogr脿fics, s'inclouen en els elements <var>vc</var>, <var>tsc</var> i <var>sc</var>, que tenen el mateix significat que els corresponents <var>v</var>, <var>ts</var> i <var>s</var>. Aquests tres nous elements inclouen un atribut <kbd>g</kbd> que indica l'脿mbit geogr脿fic (en aquests moments sempre 茅s igual a "es"). Si el darrer valor de la s猫rie de l'脿mbit de comparaci贸 (<var>tsc</var>) no est脿 disponible, <var>vc</var> estar脿 present per貌 amb el valor "_".</p> <p>Com que en aquests moments la font de les dades (tant per a Catalunya com per a Espanya) no est脿 tradu茂da, quan se sol路liciti el resultat en un idioma diferent del catal脿 tant <var>s</var> com <var>sc</var> inclouran l'atribut <kbd>lang</kbd> igual a "ca".</p> <h4 id="a2.1.3">2.1.3 Els elements <var>v</var> de l'operaci贸 <kbd>nodes</kbd></h4> <p>Els indicadors s'agrupen en apartats i subapartats. Aquesta jerarquia s'expressa en un seguit d'elements <var>v</var> imbricats. Cada element disposa d'un identificador (atribut <kbd>id</kbd>). Els nodes finals (indicadors) contenen un text descriptiu sobre la forma de c貌mput (atribut <kbd>desc</kbd>), aix铆 com la data d'actualitzaci贸 de l'indicador (atribut <kbd>date</kbd>).</p> <h6 id="e11" class="Exemple"><a href="#e11">Ex. 11</a>: Elements <var>v</var> de l'operaci贸 <kbd>nodes</kbd></h6> <pre class="codi"> <<var>v</var> <kbd>id</kbd>="0">Indicadors de conjuntura <<var>v</var> <kbd>id</kbd>="00">Comptabilitat trimestral <<var>v</var> <kbd>id</kbd>="0005" <kbd>desc</kbd>="Variaci贸 interanual en volum corregida d'efectes estacionals i de calendari" <kbd>date</kbd>="2009-11-20T14:36:00+00:00"> PIB</<var>v</var>> </<var>v</var>> <<var>v</var> <kbd>id</kbd>="01">Ind煤stria <<var>v</var> <kbd>id</kbd>="0101" <kbd>desc</kbd>="Variaci贸 interanual de l'铆ndex de producci贸 industrial" <kbd>date</kbd>="2009-10-14T08:32:00+00:00"> IPI </<var>v</var>> <<var>v</var> <kbd>id</kbd>="0102" <kbd>desc</kbd>="Saldo de respostes sobre el clima industrial" <kbd>date</kbd>="2009-11-06T10:53:00+00:00"> Clima industrial </<var>v</var>> <<var>v</var> <kbd>id</kbd>="0103" <kbd>desc</kbd>="Variaci贸 interanual de la facturaci贸 d'energia el猫ctrica" <kbd>date</kbd>="2009-11-10T12:08:00+00:00"> Energia el猫ctrica </<var>v</var>> </<var>v</var>> ... </<var>v</var>> </pre> <h3 id="a2.2">2.2 Errors</h3> <p>Les APIs de l'Idescat utilitzen <a href="/dev/api/#a2.1">codis de resposta</a> normalitzats per indicar si la petici贸 ha tingut 猫xit o si ha fracassat. Les peticions a l'API d'Indicadors al dia poden tenir 猫xit, per貌 no retornar algun dels indicadors sol路licitats, b茅 perqu猫 no existeix en l'actualitat o no ha existit mai (identificador incorrecte), b茅 perqu猫 l'indicador no estigui disponible temporalment (per exemple, perqu猫 s'est脿 revisant).</p> <h4 id="a2.2.1">2.2.1 Operaci贸 <kbd>dades</kbd></h4> <p>L'element <var>i</var> de l'indicador sense informaci贸 disposar脿 de l'atribut <kbd>error</kbd> per indicar:</p> <ul> <li><strong class="important">403</strong>: Indicador existent per貌 no disponible temporalment. L'element <var>c</var> ser脿 l'煤nic descendent retornat.</li> <li><strong class="important">404</strong>: Indicador inexistent en l'actualitat (identificador no v脿lid). L'element <var>c</var> contindr脿 un text explicatiu de l'error en l'idioma de la petici贸.</li> </ul> <p>Es pot saber el nombre d'indicadors dels quals s'ha retornat informaci贸 v脿lida gr脿cies a l'atribut <kbd>n</kbd> de l'element <var>indicadors</var>.</p> <h6 id="e12" class="Exemple"><a href="#e12">Ex. 12</a>: Sortida amb dos indicadors erronis dels tres sol路licitats</h6> <pre class="codi"> <?xml version="1.0" encoding="utf-8" ?> <<var>indicadors</var> xmlns:dc="http://purl.org/dc/elements/1.1/" lang="ca" o="dades" <kbd>n</kbd>="1" p="i=0501,9999,0701" > <<var>i</var> id="0501" <kbd>error</kbd>="403"> <<var>c</var>>Vehicles</<var>c</var>> </<var>i</var>> <<var>i</var> id="9999" <kbd>error</kbd>="404"> <<var>c</var>>Indicador no trobat</<var>c</var>> </<var>i</var>> <<var>i</var> id="0701"> <c>IPC</c> <r title="set/09">2009-09</r> <d>Variaci贸 interanual de l'铆ndex de preus de consum</d> <v>-0.5</v> <s>INE</s> <vc g="es">-1.0</vc> <sc g="es">INE</sc> <ts>4.5,3.6,2.5,1.6,1.1,1.0,0.4,0.4,-0.3,-0.5,-0.9,-0.3,-0.5</ts> <tsc g="es">4.5,3.6,2.4,1.4,0.8,0.7,-0.1,-0.2,-0.9,-1.0,-1.4,-0.8,-1.0</tsc> <u s="%">%</u> <l>https://www.idescat.cat/economia/inec?tc=3&id=0701</l> <m>https://www.idescat.cat/economia/inec?tc=7&id=0701</m> <t i="c">Conjuntura econ貌mica</t> <dc:date>2009-10-14T08:32:00+00:00</dc:date> </<var>i</var>> </<var>indicadors</var>> </pre> <h4 id="a2.2.2">2.2.2 Operaci贸 <kbd>nodes</kbd></h4> <p>L'element <var>v</var> d'aquells indicadors existents per貌 no disponibles temporalment tindr脿 l'atribut <kbd>error</kbd> amb valor <kbd>403</kbd>. A m茅s, no disposar脿 d'atribut <kbd>desc</kbd> ni <kbd>date</kbd>.</p> <h6 id="e13" class="Exemple"><a href="#e13">Ex. 13</a>: Fragment de l'arbre amb un indicador no disponible temporalment</h6> <pre class="codi"> <v id="59">Sector exterior <v id="5901" <kbd>error</kbd>="403">Exportacions</v> <v id="5905" desc="Variaci贸 de les importacions" date="2009-10-24T17:32:00+00:00">Importacions</v> </v> </pre> </div> </div> </div> </div> </main> <footer id="Peu" role="contentinfo"> <div class="aplec"> <div id="OnSou" class="xs-visible"> <h2>Sou aqu铆:</h2> <ul><li><a href="/dev/">脌rea de desenvolupadors</a></li><li><a href="/dev/api/">API</a></li><li>Indicadors al dia. API </li></ul> </div> <div id="idiomes" role="navigation" aria-label="Idioma de la p脿gina"> <ul><li><a href="?lang=es" title="Esta página está traducida total o parcialmente al castellano" hreflang="es">es</a></li><li><a href="?lang=en" title="This page is totally or partially translated into English" hreflang="en">en</a></li></ul> </div> <ul id="Copyright"> <li><a href="/institut/web/">Avís legal</a></li> <li><a href="/institut/web/accessibilitat/">Accessibilitat</a></li> <li><a href="/institut/" class="idescat">Institut d'Estadística de Catalunya</a></li> </ul> <div class="Datacio"><time datetime="2024-04-22T05:56:00Z">22/04/2024</time></div> <ul id="xarxes"> <li><a href="https://x.com/idescat"><img src="/images/xc.png" alt="X" title="X"></a></li> <li><a href="https://www.linkedin.com/company/idescat/"><img src="/images/linkedinc.png" alt="LinkedIn" title="LinkedIn"></a></li> </ul> <ul id="generalitat"> <li><a href="http://web.gencat.cat/ca/inici/"><img src="/images/mgencat.png" alt="www.gencat.cat"></a></li> <li><a class="amunt">Torna amunt</a></li> </ul> <div id="pujar" class="amunt"></div> </div> </footer> </div> <script> IDESCAT.ini(); </script> </body></html>

CINXE.COM

Idescat. 脌rea de desenvolupadors. API. Indicadors al dia