Idescat. 脌rea de desenvolupadors. API. Rectificacions

<!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. Rectificacions</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">Rectificacions. <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>L'<abbr title="Interf铆cie de programaci贸 d'aplicacions">API</abbr> de Rectificacions dona acc茅s a la informaci贸 del <a href="/rectificacions/">registre de rectificacions</a> del lloc web de l'Idescat.</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/rectificacions/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 (20/10/2010)</td> </tr> <tr> <th scope="row">Dreceres</th> <td><a href="#a1">Petici贸</a>, <a href="#a2">Resposta</a></td> </tr> <tr> <th scope="row">Operacions</th> <td>cerca, categories</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. Caracter铆stiques b脿siques</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>cerca</kbd></a> <ul> <li><a href="#a1.2.1.1">1.2.1.1. <var>posicio</var></a></li> <li><a href="#a1.2.1.2">1.2.1.2. <var>id</var></a></li> <li><a href="#a1.2.1.3">1.2.1.3. <var>scheme</var></a></li> <li><a href="#a1.2.1.4">1.2.1.4. <var>published</var> i <var>updated</var></a></li> <li><a href="#a1.2.1.5">1.2.1.5. <var>orderby</var> i <var>desc</var></a></li> </ul> </li> <li><a href="#a1.2.2">1.2.2. Operaci贸 <kbd>categories</kbd></a> <ul> <li><a href="#a1.2.2.1">1.2.2.1. <var>id</var></a></li> </ul> </li> </ul> </li> <li><a href="#a1.3">1.3. Invocaci贸 sense operaci贸</a></li> </ul> </li> <li><a href="#a2">2. Resposta</a> <ul> <li><a href="#a2.1">2.1. Operaci贸 <kbd>cerca</kbd></a> <ul> <li><a href="#a2.1.1">2.1.1. <var>title</var></a></li> <li><a href="#a2.1.2">2.1.2. <var>published</var> i <var>updated</var></a></li> <li><a href="#a2.1.3">2.1.3. <var>content</var></a></li> <li><a href="#a2.1.4">2.1.4. <var>link</var></a></li> <li><a href="#a2.1.5">2.1.5. <var>category</var></a></li> </ul> </li> <li><a href="#a2.2">2.2. Operaci贸 <kbd>categories</kbd></a> <ul> <li><a href="#a2.2.1">2.2.1. <var>title</var></a></li> <li><a href="#a2.2.2">2.2.2. <var>link</var></a></li> <li><a href="#a2.2.3">2.2.3. <var>content</var></a></li> <li><a href="#a2.2.4">2.2.4. <var>category</var></a></li> </ul> </li> <li><a href="#a2.3">2.3. Errors</a></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. Caracter铆stiques b脿siques</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. El servei de Rectificacions 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>L'identificador d'aquest servei 茅s <kbd>rectificacions</kbd>.</p> <pre class="uri">https://api.idescat.cat/<kbd>rectificacions</kbd><wbr />/<kbd>v1</kbd><wbr />/{…}</pre> <h4 id="a1.1.2">1.1.2. Operacions</h4> <p>Aquest servei admet dos tipus d'operacions:</p> <ul> <li> <kbd>cerca</kbd>: Retorna les rectificacions que compleixen el criteri de selecci贸. <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/<kbd>cerca</kbd>.{…}</pre> </li> <li> <kbd>categories</kbd>: Permet obtenir informaci贸 sobre les categories emprades en la categoritzaci贸 de les rectificacions. <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/<kbd>categories</kbd>.{…}</pre> </li> </ul> <h3 id="a1.2">1.2. Par脿metres espec铆fics</h3> <p>Els par脿metres espec铆fics permeten escollir la informaci贸 que retornar脿 una determinada operaci贸 del servei. 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>).</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>cerca</kbd></h4> <p>L'operaci贸 <kbd>cerca</kbd> es pot invocar sense emprar cap par脿metre espec铆fic (resultats no filtrats). En aquest cas, retornar脿 les rectificacions m茅s antigues.</p> <h6 id="e1" class="Exemple"><a href="#e1">Ex. 1</a>: Llista de rectificacions m茅s antigues en format JSON i codificaci贸 ISO-8859-1</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.json<wbr />?enc=iso-8859-1</pre> <p>Per accedir a rectificacions m茅s recents cal utilitzar el par脿metre <var>desc</var> (o el par脿metre <var>posicio</var>).</p> <h5 id="a1.2.1.1">1.2.1.1. <var>posicio</var></h5> <p>Com algunes cerques poden retornar un nombre molt elevat de resultats, la resposta no sempre els inclour脿 tots. El par脿metre <var>posicio</var> permet especificar quin ha de ser el primer resultat incl貌s a la resposta. Per defecte, <var>posicio</var> 茅s igual a zero.</p> <h6 id="e2" class="Exemple"><a href="#e2">Ex. 2</a>: Llista a partir de la rectificaci贸 21</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?posicio=20</pre> <p>Els elements de la resposta <var>opensearch:totalResults</var> i <var>opensearch:itemsPerPage</var> permeten determinar si s'estan mostrant tots els resultats o no.</p> <h5 id="a1.2.1.2">1.2.1.2. <var>id</var></h5> <p>Quan no va acompanyat del par脿metre <var>scheme</var> (vegeu l'<a href="#a1.2.1.3">apartat seg眉ent</a>), el par脿metre <var>id</var> permet seleccionar la informaci贸 d'una rectificaci贸 individual.</p> <h6 id="e3" class="Exemple"><a href="#e3">Ex. 3</a>: Informaci贸 de la rectificaci贸 amb l'identificador 27</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?id=27</pre> <h5 id="a1.2.1.3">1.2.1.3. <var>scheme</var></h5> <p>Aquest par脿metre, acompanyat del par脿metre <var>id</var>, permet filtrar els resultats per alguna de les categories emprades en la categoritzaci贸 de les rectificacions. Per con猫ixer els criteris de categoritzaci贸, utilitzeu l'<a href="#a1.2.2">operaci贸 <kbd>categories</kbd></a>.</p> <p>El par脿metre <var>scheme</var> s'utilitza per seleccionar el criteri i el par脿metre <var>id</var> s'utilitza per seleccionar la categoria.</p> <h6 id="e4" class="Exemple"><a href="#e4">Ex. 4</a>: Llista de rectificacions de la categoria treball ("treba") de la classificaci贸 segons "tema"</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?scheme=tema<wbr />&id=treba</pre> <p>Per incloure m茅s d'una categoria, s'utilitzar脿 la coma.</p> <h6 id="e5" class="Exemple"><a href="#e5">Ex. 5</a>: Llista de rectificacions amb la categoria treball ("treba") o amb la categoria turisme ("turis") de la classificaci贸 segons "tema"</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?scheme=tema<wbr />&id=treba,turis</pre> <p>Per filtrar simult脿niament segons dos criteris s'utilitzar脿 "+" en el par脿metre <var>scheme</var> i <var>id</var>:</p> <h6 id="e6" class="Exemple"><a href="#e6">Ex. 6</a>: Llista de rectificacions amb estad铆stica ("estad") igual a "afi" i amb "tema" igual a treball ("treba") o a turisme ("turis")</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?scheme=tema+estad<wbr />&id=treba,turis+afi</pre> <h5 id="a1.2.1.4">1.2.1.4. <var>published</var> i <var>updated</var></h5> <p>Aquests par脿metres filtren els resultats segons un per铆ode temporal: segons la data en la qual es va publicar la informaci贸 abans de ser rectificada (<var>published</var>) i segons la data en la qual es va produir la rectificaci贸 (<var>updated</var>). Cal especificar almenys un dia, mes i any en format AAAAMMDD.</p> <h6 id="e7" class="Exemple"><a href="#e7">Ex. 7</a>: Llista de rectificacions des de l'1 de gener del 2010 fins a l'actualitat</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?updated=20100101</pre> <p>Per definir un interval, s'utilitzar脿 un gui贸.</p> <h6 id="e8" class="Exemple"><a href="#e8">Ex. 8</a>: Llista de rectificacions des de l'1 al 31 de gener del 2010 (ambd貌s inclosos)</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?updated=20100101-20100131</pre> <p>El gui贸 es pot emprar per seleccionar les rectificacions d'un determinat dia.</p> <h6 id="e9" class="Exemple"><a href="#e9">Ex. 9</a>: Llista de rectificacions del dia 8 d'octubre del 2010 </h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/cerca.xml<wbr />?updated=20101008-20101008</pre> <h5 id="a1.2.1.5">1.2.1.5. <var>orderby</var> i <var>desc</var></h5> <p>Per defecte, els resultats es mostren en ordre ascendent de data de la rectificaci贸 (<var>updated</var>). Els par脿metres <var>orderby</var> i <var>desc</var> permeten modicar aquest criteri d'ordenaci贸.</p> <ul> <li> <var>orderby</var> <ul> <li><kbd class="defecte">updated</kbd>: Ordenat segons la data de la rectificaci贸. 脡s el valor per defecte.</li> <li><kbd>published</kbd>: Ordenat segons la data de publicaci贸 de la informaci贸 abans de ser rectificada.</li> <li><kbd>title</kbd>: Ordenat segons la denominaci贸 de la informaci贸 afectada per la rectificaci贸. Aquesta ordenaci贸 dep猫n de l'idioma.</li> <li><kbd>tema</kbd>: Ordenat segons el text descriptiu del tema de la rectificaci贸. Aquesta ordenaci贸 dep猫n de l'idioma.</li> <li><kbd>estad</kbd>: Ordenat segons l'identificador de l'estad铆stica.</li> </ul> </li> <li> <var>desc</var> <ul> <li><kbd class="defecte">0</kbd>: Ordre ascendent. 脡s el valor per defecte.</li> <li><kbd>1</kbd>: Ordre descendent.</li> </ul> </li> </ul> <h4 id="a1.2.2">1.2.2. Operaci贸 <kbd>categories</kbd></h4> <p>L'operaci贸 <kbd>categories</kbd> es pot invocar sense emprar cap par脿metre espec铆fic per obtenir els identificadors dels criteris de categoritzaci贸 de la informaci贸.</p> <h6 id="e10" class="Exemple"><a href="#e10">Ex. 10</a>: Llista de criteris de categoritzaci贸 de les rectificacions en format PHP serialitzat</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/categories.php</pre> <p>Els identificadors retornats es poden utilitzar com a par脿metre <var>id</var> (vegeu el <a href="#a1.2.2.1">seg眉ent apartat</a>) per obtenir les seves categories.</p> <h5 id="a1.2.2.1">1.2.2.1. <var>id</var></h5> <p>Per obtenir les categories emprades en un determinat criteri, s'utilitzar脿 el par脿metre <var>id</var>.</p> <h6 id="e11" class="Exemple"><a href="#e11">Ex. 11</a>: Llista de categories del criteri "tema" en format XML</h6> <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/categories.xml<wbr />?id=tema</pre> <h3 id="a1.3">1.3. Invocaci贸 sense operaci贸</h3> <p>Com en el cas d'altres APIs, aquesta tamb茅 admet peticions amb una sintaxi que no requereix especificar operacions (<kbd>categories</kbd> i <kbd>cerca</kbd>, en aquest cas; vegeu, a la documentaci贸 general de les APIs de l'Idescat, l'apartat <a href="/dev/api/?#a1.4">1.4. Invocaci贸 sense operaci贸</a>). Els avantatges d'aquest tipus d'invocaci贸, per貌, s贸n menys clars que en altres APIs perqu猫 no suposa una simplificaci贸 significativa de les crides, ja que cal a definir igualment dues classes de recursos (<kbd>categories</kbd> i <kbd>rectificacions</kbd>).</p> <ul> <li>Llista de criteris de categoritzaci贸 de les rectificacions en format XML <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/categories.xml</pre> </li> <li>Llista de categories del criteri "tema" en format JSON <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/categories<wbr />/tema.json</pre> </li> <li>Llista de rectificacions del dia 8 d'octubre del 2010 en format PHP serialitzat <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/rectificacions.php<wbr />?updated=20101008-20101008</pre> </li> <li>Llista de rectificacions de la categoria treball ("treba") de la classificaci贸 segons "tema" en format XML <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/rectificacions.xml<wbr />?scheme=tema<wbr />&id=treba</pre> </li> <li>Informaci贸 de la rectificaci贸 amb l'identificador 27 en format XML <pre class="uri">https://api.idescat.cat/rectificacions<wbr />/v1<wbr />/rectificacions<wbr />/27.xml</pre> </li> </ul> </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> <p>L'API de Rectificacions utilitza, per descriure la informaci贸, l'est脿ndard <a href="http://www.atomenabled.org/developers/syndication/" class="extern" target="_blank" rel="noopener" title="Vincle extern: s'obrir脿 una nova finestra">Atom</a>, ja es tracti de llistes de rectificacions (operaci贸 <kbd>cerca</kbd>) com de criteris de categoritzaci贸 o categories (operaci贸 <kbd>categories</kbd>).</p> <h3 id="a2.1">2.1. Operaci贸 <kbd>cerca</kbd></h3> <p>L'operaci贸 <kbd>cerca</kbd> utilitza, per descriure les rectificacions, l'est脿ndard <a href="http://www.atomenabled.org/developers/syndication/" class="extern" target="_blank" rel="noopener" title="Vincle extern: s'obrir脿 una nova finestra">Atom</a> enriquit amb elements de l'est脿ndard <a href="http://www.opensearch.org/Specifications/OpenSearch/1.1#OpenSearch_response_elements" class="extern" target="_blank" rel="noopener" title="Vincle extern: s'obrir脿 una nova finestra">OpenSearch</a>. Consulteu la documentaci贸 d'aquests est脿ndards per con猫ixer l'estructura de la resposta de l'operaci贸 <kbd>cerca</kbd>: aqu铆 nom茅s es documenten alguns elements fills de l'element <var>entry</var> que tenen un 煤s especial.</p> <h4 id="a2.1.1">2.1.1. <var>title</var></h4> <p>L'operaci贸 <kbd>cerca</kbd> utilitza l'element <var>title</var> per especificar la informaci贸 afectada per la rectificaci贸.</p> <h6 id="e12" class="Exemple"><a href="#e12">Ex. 12</a>: Element <var>title</var></h6> <pre class="codi"><entry> <<var>title</var> xml:lang="ca">Atur registrat</<var>title</var>> ... </entry></pre> <h4 id="a2.1.2">2.1.2. <var>published</var> i <var>updated</var></h4> <p>L'operaci贸 <kbd>cerca</kbd> utilitza l'element <var>published</var> per especificar la data en la qual es va publicar la informaci贸 abans de ser rectificada i l'element <var>updated</var> per a la data en la qual es va produir la rectificaci贸.</p> <h6 id="e13" class="Exemple"><a href="#e13">Ex. 13</a>: Elements <var>published</var> i <var>updated</var></h6> <pre class="codi"><<var>published</var>>2009-01-10</<var>published</var>> <<var>updated</var>>2010-02-15</<var>updated</var>></pre> <h4 id="a2.1.3">2.1.3. <var>content</var></h4> <p>L'operaci贸 <kbd>cerca</kbd> inclou la descripci贸 de la rectificaci贸 a l'element <var>content</var> en format <abbr title="eXtensible Hypertext Markup Language">XHTML</abbr>.</p> <h6 id="e14" class="Exemple"><a href="#e14">Ex. 14</a>: Element <var>content</var></h6> <pre class="codi"><<var>content</var> xml:lang="ca" type="xhtml"> <div xmlns="http://www.w3.org/1999/xhtml"> ... </div> </<var>content</var>></pre> <h4 id="a2.1.4">2.1.4. <var>link</var></h4> <p>Els enlla莽os a les p脿gines afectades per la rectificaci贸 s'inclouen en elements <var>link</var> amb atribut <kbd>rel</kbd> igual a <kbd>via</kbd>. L'atribut <kbd>title</kbd> s'utilitza per oferir una descripci贸 de la p脿gina afectada en l'idioma sol路licitat.</p> <h6 id="e15" class="Exemple"><a href="#e15">Ex. 15</a>: Elements <var>link</var> amb <kbd>rel</kbd> igual a <kbd>via</kbd></h6> <pre class="codi"><<var>link</var> <kbd>rel</kbd>="<kbd>via</kbd>" xml:lang="ca" type="text/html" href="https://www.idescat.cat/pub/?id=lma&amp;n=8.3.1.1" title="Persones de 16 anys i m茅s que estan a favor de prendre mesures per a la protecci贸 del medi ambient. Per 脿mbits territorials i tipus de mesura" /> <<var>link</var> <kbd>rel</kbd>="<kbd>via</kbd>" xml:lang="ca" type="text/html" href="https://www.idescat.cat/pub/?id=lma&amp;n=8.3.1.2" title="Persones de 16 anys i m茅s que estan a favor de prendre mesures per a la protecci贸 del medi ambient. Per dimensi贸 del municipi i tipus de mesura" /></pre> <h4 id="a2.1.5">2.1.5. <var>category</var></h4> <p>L'operaci贸 <kbd>cerca</kbd> classifica els diferents resultats utilitzant elements <var>category</var>. L'atribut <kbd>scheme</kbd> indica el criteri de categoritzaci贸 amb la petici贸 a l'API que retorna la seva llista de categories possibles (vegeu l'<a href="#a2.2">apartat 2.2.</a>). L'atribut <kbd>term</kbd> indica l'identificador de la categoria. L'atribut <kbd>label</kbd> inclou un literal descriptiu de la categoria en l'idioma de la petici贸.</p> <h6 id="e16" class="Exemple"><a href="#e16">Ex. 16</a>: Elements <var>category</var></h6> <pre class="codi"><<var>category</var> scheme="https://api.idescat.cat/rectificacions/v1/categories.xml?id=tema" term="xifpo" label="Xifres de poblaci贸" xml:lang="ca" /> <<var>category</var> scheme="https://api.idescat.cat/rectificacions/v1/categories.xml?id=estad" term="ep" label="Estimacions de poblaci贸" xml:lang="ca" /> <<var>category</var> scheme="https://api.idescat.cat/rectificacions/v1/categories.xml?id=servei" term="anuals" label="Indicadors anuals" xml:lang="ca" /></pre> <h3 id="a2.2">2.2. Operaci贸 <kbd>categories</kbd></h3> <p>L'operaci贸 <kbd>categories</kbd> utilitza, per exposar la categoritzaci贸 de les rectificacions, l'est脿ndard <a href="http://www.atomenabled.org/developers/syndication/" class="extern" target="_blank" rel="noopener" title="Vincle extern: s'obrir脿 una nova finestra">Atom</a>. Consulteu la documentaci贸 d'aquest est脿ndard per con猫ixer l'estructura de la resposta de l'operaci贸 <kbd>categories</kbd>: aqu铆 nom茅s es documenten alguns elements fills de l'element <var>entry</var> que tenen un 煤s especial.</p> <h4 id="a2.2.1">2.2.1. <var>title</var></h4> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca sense <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de criteris de categoritzaci贸), l'element <var>title</var> de cada <var>entry</var> inclou l'identificador del criteri de categoritzaci贸.</p> <h6 id="e17" class="Exemple"><a href="#e17">Ex. 17</a>: Element <var>title</var> en una invocaci贸 sense <var>id</var></h6> <pre class="codi"><entry> <id>tag:idescat.cat,2010:rectificacions/categories/tema</id> <<var>title</var>>tema</<var>title</var>> <content xml:lang="ca">Temes</content> <category term="1" /> <link rel="alternate" href="https://api.idescat.cat/rectificacions/v1/categories.xml?id=tema" type="application/atom+xml" /> <updated>2010-10-15</updated> </entry></pre> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca amb <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de categories del criteri seleccionat), l'element <var>title</var> de cada <var>entry</var> inclou l'identificador de la categoria.</p> <h6 id="e18" class="Exemple"><a href="#e18">Ex. 18</a>: Element <var>title</var> en una invocaci贸 amb <var>id</var> igual a "tema"</h6> <pre class="codi"><entry> <id>tag:idescat.cat,2010:rectificacions/categories/tema/macro</id> <<var>title</var>>macro</<var>title</var>> <content xml:lang="ca">Macromagnituds</content> <updated>2011-09-15</updated> </entry></pre> <h4 id="a2.2.2">2.2.2. <var>link</var></h4> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca sense <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de criteris de categoritzaci贸), l'element <var>link</var> de cada <var>entry</var> inclou en el seu atribut <kbd>href</kbd> la petici贸 a l'API de la llista de categories del criteri especificat a l'element <var>title</var> de l'<var>entry</var>.</p> <h6 id="e19" class="Exemple"><a href="#e19">Ex. 19</a>: Element <var>link</var> en una invocaci贸 sense <var>id</var></h6> <pre class="codi"><entry> <id>tag:idescat.cat,2010:rectificacions/categories/tema</id> <title>tema</title> <content xml:lang="ca">Temes</content> <category term="1" /> <<var>link</var> rel="alternate" <kbd>href</kbd>="https://api.idescat.cat/rectificacions/v1/categories.xml?id=tema" type="application/atom+xml" /> <updated>2018-05-23</updated> </entry></pre> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca amb <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de categories del criteri seleccionat), l'element <var>link</var> no apareix.</p> <h4 id="a2.2.3">2.2.3. <var>content</var></h4> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca sense <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de criteris de categoritzaci贸), l'element <var>content</var> inclou el literal associat a l'identificador del criteri de categoritzaci贸 que apareix a l'element <var>title</var>.</p> <h6 id="e20" class="Exemple"><a href="#e20">Ex. 20</a>: Element <var>content</var> en una invocaci贸 sense <var>id</var></h6> <pre class="codi"><entry> <id>tag:idescat.cat,2010:rectificacions/categories/tema</id> <title>tema</title> <<var>content</var> xml:lang="ca">Temes</<var>content</var> > <category term="1" /> <link rel="alternate" href="https://api.idescat.cat/rectificacions/v1/categories.xml?id=tema" type="application/atom+xml" /> <updated>2018-05-23</updated> </entry></pre> <p>Aquest mateix literal apareix dins l'element <var>title</var> fill de <var>feed</var> quan l'operaci贸 <kbd>categories</kbd> s'invoca amb <var>id</var>.</p> <h6 id="e21" class="Exemple"><a href="#e21">Ex. 21</a>: Element <var>title</var> fill de <var>feed</var> en una invocaci贸 amb <var>id</var> igual a "tema"</h6> <pre class="codi"><feed xmlns="http://www.w3.org/2005/Atom"> <id>tag:idescat.cat,2010:rectificacions/categories/tema</id> <<var>title</var> xml:lang="ca">Temes</<var>title</var>> <category term="1" /> ... </feed></pre> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca amb <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de categories del criteri seleccionat), l'element <var>content</var> inclou el literal associat a l'identificador de la categoria que apareix a l'element <var>title</var>.</p> <h6 id="e22" class="Exemple"><a href="#e22">Ex. 22</a>: Element <var>content</var> en una invocaci贸 amb <var>id</var> igual a "tema"</h6> <pre class="codi"><entry> <id>tag:idescat.cat,2010:rectificacions/categories/tema/macro</id> <title>macro</title> <<var>content</var> xml:lang="ca">Macromagnituds</<var>content</var>> <updated>2011-09-15</updated> </entry></pre> <h4 id="a2.2.4">2.2.4. <var>category</var></h4> <p>L'operaci贸 <kbd>categories</kbd> utilitza l'atribut <kbd>term</kbd> de l'element <var>category</var> per expressar si ha d'apar猫ixer una categoria, i nom茅s una, del criteri en q眉esti贸 per a cada rectificaci贸 ("1"), si ha d'apar猫ixer com a m铆nim una per貌 poden apar猫ixer m茅s ("+"), si en poden apar猫ixer m茅s d'una per貌 tamb茅 cap ("*") o si la categoria ha de ser 煤nica per貌 pot no haver-n'hi cap ("?").</p> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca sense <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de criteris de categoritzaci贸), l'element <var>category</var> s'associa a cada element <var>entry</var>.</p> <h6 id="e23" class="Exemple"><a href="#e23">Ex. 23</a>: Element <var>category</var> en una invocaci贸 sense <var>id</var></h6> <pre class="codi"><entry> <id>tag:idescat.cat,2010:rectificacions/categories/tema</id> <title>tema</title> <content xml:lang="ca">Temes</content > <<var>category</var> <kbd>term</kbd>="1" /> <link rel="alternate" href="https://api.idescat.cat/rectificacions/v1/categories.xml?id=tema" type="application/atom+xml" /> <updated>2018-05-23</updated> </entry></pre> <p>Quan l'operaci贸 <kbd>categories</kbd> s'invoca amb <a href="#a1.2.2.1">par脿metre <var>id</var></a> (llista de categories del criteri seleccionat), l'element <var>category</var> s'associa a l'element <var>feed</var>.</p> <h6 id="e24" class="Exemple"><a href="#e24">Ex. 24</a>: Element <var>category</var> fill de <var>feed</var> en una invocaci贸 amb <var>id</var> igual a "tema"</h6> <pre class="codi"><feed xmlns="http://www.w3.org/2005/Atom"> <id>tag:idescat.cat,2010:rectificacions/categories/tema</id> <title xml:lang="ca">Temes</title> <<var>category</var> <kbd>term</kbd>="1" /> ... </feed></pre> <h3 id="a2.3">2.3. 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.</p> </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>Rectificacions. 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="2020-10-15T06:30:00Z">15/10/2020</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. Rectificacions