Una API o interfície de programació d’aplicacions és un conjunt de mètodes que recuperen dades perquè puguin ser processades per altres aplicacions.
Un cop es coneix l’estructura de les dades, només cal cridar els mètodes corresponents, tenint en compte que es poden combinar els mètodes entre si.
Adjunt | Mida |
---|---|
![]() | 4.4 MB |
Una API o interfície de programació d’aplicacions és un conjunt de mètodes per recuperar dades perquè puguin ser processades per altres aplicacions.
REST és una arquitectura de software per a sistemes hipermèdia. Actualment REST és el terme que s'utilitza per descriure tota interfície entre sistemes que utilitzi el protocol HTTP per a determinar operacions a ser executades sobre un conjunt de dades o directament obtenir-les, formatades i sense les complicacions pròpies de realitzar aquesta tasca a un nivell més directe.
Un cop es coneix l’estructura de les dades, només cal cridar els mètodes corresponents, tenint en compte que es poden combinar els mètodes entre si.
El Cercador d’Informació i Documentació Oficials (CIDO) ofereix una API de dades obertes per poder realitzar consultes M2M (machine to machine). L’API està basada en l’estàndard JSON:API v1.0 (https://jsonapi.org/).
La base de dades del CIDO estructura la informació de forma relacional, les dades s’emmagatzemen en registres organitzats en taules que es relacionen entre sí. Donat que aquesta estructura relacional s’ha mantingut en l’API de dades obertes, cal tenir en compte el següent:
Per estructurar les dades de l’API s’utilitzen els següents conceptes:
L'API de dades obertes consta de diferents tipus de camps i cada camp pot tenir diferents propietats:
Tipus de camps
Propietats dels camps
Per obtenir una llista de resultats d’una entitat es farà servir la següent estructura:
/cido/v1/nomEntitat
Per obtenir les dades d’un registre concret es farà servir la següent estructura:
/cido/v1/nomEntitat/id
Cada entitat pot tenir diverses relacions (veure apartat de relacions).
Per obtenir les dades de la relació es farà servir la següent estructura:
/cido/v1/nomEntitat/id/nomRelacio
Per aplicar filtres a les cerques s’ha de fer servir el paràmetre filter amb el següent format:
Si no s’informa l’etiqueta [operador] es considerarà [EQ] per defecte. I la concatenació de múltiples paràmetres filter aplicarà un AND entre ells.
Es poden aplicar filtres avançats fent servir JSON com a valor del paràmetre filter. Per exemple, per aplicar un OR entre múltiples paràmetres, els valors hauran d’estar separats per comes (,):
Aquest filtre retornaria les entitats que compleixin: idEstat = 1 OR idEstat = 2 OR idEstat = 3.
Si el filtre es realitza sobre una relació:
La funcionalitat de filtrar per nodes es troba disponible a les entitats institucions, materies i beneficiaris.
Per recuperar els anuncis d’una institució concreta i de les institucions jeràrquicament inferiors a aquesta (node), s’estableixen relacions amb el següent format:
/cido/v1/institucions/id/nomEntitat-relacionades
Per exemple, per obtenir les oposicions d’una institució concreta i de les institucions jeràrquicament inferiors a aquesta:
/cido/v1/institucions/id/oposicions-relacionades
Aquesta mateixa relació també permet recuperar les dades a la inversa, és a dir, les institucions jeràrquicament superiors a la institució d’un anunci. Per exemple, per obtenir la institució d’una oposició i les institucions jeràrquicament superiors a aquesta:
/cido/v1/oposicions/id/institucions-vinculades
La funcionalitat de filtrar per territori d’aplicació es troba disponible a les entitats subvencions i normatives-locals.
Per recuperar els anuncis que apliquen en un municipi concret es disposa de les següents relacions:
També es poden obtenir les dades dels municipis en els quals impacta una subvenció o normativa amb la següent estructura:
/cido/v1/nomEntitat/id/municipis-impacte
Aquesta funcionalitat només és aplicable als 947 ajuntaments de Catalunya.
Els operadors admesos són els següents:
Hi ha alguns caràcters especials que han d’anar codificats de manera que siguin vàlids a la URL. Alguns exemples:
Per aplicar la paginació cal fer servir els següents paràmetres:
Per defecte es retornen 500 resultats i com a màxim es poden demanar 2.000 resultats en cada consulta.
Generalment, el número de resultats a saltar (offset) correspon al número de pàgina que es vol obtenir (començant per la pàgina 0) multiplicat pel número de resultats (límit) que s’obtenen per pàgina.
Per ordenar els resultats de cerques cal fer servir el paràmetre sort indicant com a valor els camps que es faran servir per l’ordenació. Si un camp està precedit per -, voldrà dir que s’ordenarà de manera descendent.
Per exemple:
L’API retornarà resultats de dos tipus:
Oposicions
Borses de treball d'accés lliure de les administracions públiques catalanes:
Oposicions d'accés lliure de les administracions publiques catalanes:
https://api.diba.cat/dadesobertes/cido/v1/oposicions?sort=-maxDataPublicacioDocument
Oposicions d'accés lliure de les administracions públiques catalanes amb el termini de presentació d'instàncies obert:
Oposicions d'accés lliure de les administracions públiques catalanes convocades pel sistema de concurs:
Oposicions d'accés lliure de les administracions públiques catalanes convocades en règim d'interinatge:
Oposicions d'accés lliure de la Diputació de Barcelona:
Oposicions d'accés lliure de les administracions públiques catalanes amb places reservades a persones amb discapacitat:
Oposicions d'accés lliure de les administracions públiques catalanes amb places reservades a joves:
Oposicions d'accés lliure de les administracions públiques catalanes amb places reservades a aturats:
Oposicions d'accés lliure de les administracions públiques catalanes amb places reservades a dones:
Contractació
Licitacions obertes de contractes administratius o privats que afecten l'àmbit territorial català:
Contractes de gestió i prestació de serveis que afecten l'àmbit territorial català:
Contractes d'obres que afecten l'àmbit territorial català:
Contractes privats que afecten l'àmbit territorial català:
Contractes de subministraments que afecten l'àmbit territorial català:
Contractes administratius o privats que afecten l'àmbit territorial català:
https://api.diba.cat/dadesobertes/cido/v1/contractacions?sort=-maxDataPublicacioDocument
Oportunitats de negoci amb el sector públic d’agroalimentària:
Oportunitats de negoci amb el sector públic d’assessorament, estudis i anàlisis:
Oportunitats de negoci amb el sector públic de construcció i instal·lacions:
Oportunitats de negoci amb el sector públic d’educació, cultura i oci:
Oportunitats de negoci amb el sector públic d’energia:
Oportunitats de negoci amb el sector públic d’activitats financeres i d’assegurances:
Oportunitats de negoci amb el sector públic de salut, serveis socials, protecció i neteja:
Oportunitats de negoci amb el sector públic de sanejament i residus:
Oportunitats de negoci amb el sector públic de TIC:
Oportunitats de negoci amb el sector públic de transport i logística:
Oportunitats de negoci amb el sector públic de turisme i hostaleria:
Subvencions
Beques adreçades a qualsevol col·lectiu de Catalunya:
Cursos adreçats a qualsevol col·lectiu de Catalunya:
Premis adreçats a qualsevol col·lectiu de Catalunya:
Subvencions adreçades a qualsevol col·lectiu de Catalunya:
Subvencions adreçades als ens locals de Catalunya
Ajuts adreçats a la ciutadania de Catalunya:
Ajuts adreçats a estudiants:
Ajuts adreçats a infants i famílies:
Ajuts adreçats a personal de l’Administració pública:
Ajuts adreçats a personal docent:
Ajuts adreçats a persones amb discapacitat:
Ajuts adreçats a dones:
Ajuts adreçats a gent gran:
Ajuts adreçats a joves:
Ajuts adreçats a personal d’investigació i recerca:
Ajuts adreçats a persones a l’atur:
Ajuts adreçats a titulats universitaris:
Ajuts adreçats a persones en situació de vulnerabilitat:
Ajuts adreçats al teixit productiu:
Ajuts adreçats a les empreses:
Ajuts adreçats a la petita i mitjana empresa:
Ajuts adreçats a professionals i autònoms:
Ajuts per a fer front a la crisi ocasionada per la COVID-19 adreçats a qualsevol col·lectiu:
Ajuts per a fer front a la crisi ocasionada per la COVID-19 adreçats a persones i famílies:
Ajuts per a fer front a la crisi ocasionada per la COVID-19 adreçats al teixit productiu:
Subvencions que apliquen al municipi d’Abrera:
Normativa local
Calendaris i padrons fiscals de l'Administració local catalana:
Estatuts d'ens que pertanyen a l'àmbit territorial català:
Ordenances i convenis tipus de les administracions públiques catalanes:
Ordenances fiscals:
Ordenances reguladores i reglaments de l'Administració local catalana:
Pressupostos i plantilles de l'Administració local catalana:
Normativa local que aplica al municipi de Gavà:
Normativa local d’afectació a Gavà en matèria de serveis socials:
Normativa local que regula l’activitat empresarial a Gavà:
Mesures adoptades pels ens locals per fer front a la crisi ocasionada per la COVID-19:
Convenis col·lectius
Convenis col·lectius d'empreses publicats al BOE, al DOGC i als butlletins provincials de Catalunya:
Pactes i acords del personal al servei dels ajuntaments de Catalunya publicats al BOE, al DOGC i als butlletins provincials de Catalunya:
Convenis col·lectius que afecten un sector determinat, d'àmbit territorial català o estatal, publicats al BOE, al DOGC i als butlletins provincials de Catalunya:
Convenis col·lectius d'ens no municipals, ni empresarials publicats al BOE, al DOGC i als butlletins provincials de Catalunya:
Institucions
Institucions de la comarca del Baix Llobregat:
Consorcis d’àmbit local:
Matèries
Matèries de l’apartat Oposicions:
https://api.diba.cat/dadesobertes/cido/v1/materies?filter[idModul]=4&sort=materia
Beneficiaris
Beneficiaris dependents de Teixit productiu: