Una interfície de programació d'aplicacions o API és un mecanisme que permet la comunicació i intercanvi d'informació entre sistemes. Les plataformes de dades obertes, com datos.gob.es
, expliquen amb este tipus de ferramentes per a interactuar amb el sistema d'informació i consultar les dades sense necessitat d'un coneixement de l'estructura interna o de la tecnologia utilitzada en el seu desenvolupament. Gràcies a les APIs, els reutilisadors poden accedir més fàcilment la informació que necessiten de forma automàtica, sent possible ajustar la descàrrega exclusivament a les dades requerides.
Cada vegada són més els organismes que aposta per este tipus de mecanismes, sobretot per a publicar dades amb alta freqüència d'actualització com les dades en temps real. La pròpia directiva europea de sobre dades obertes i reutilització de la informació del sector públic referix la necessitat de comptar amb este tipus de mecanismes per a la publicació de dades dinàmiques i d'alt valor. Es habitual usar APIs per a accedir a dades meteorològiques, de transport públic o els produïts per sensors de monitoratge urbans, encara que cal destacar que les APIs són adequades per a consumir tot tipus de dades.
Amb l'objectiu de ajudar a aquells portals de dades obertes que encara no expliquen amb una API, des de datos.gob.es hem preparat un guia amb les principals pautes a seguir a l'hora de definir i posar en marxa este mecanisme d'accés a les dades.
Què pot trobar el lector en esta guia?
La Guia per a la publicació de dades obertes utilitzant APIs comença amb un primer apartat dedicat a entendre què són les APIS i quin és el seu valor. En ell s'explica com funcionen i s'implementen. Per a aquells que vullguen ampliar la informació, es recomana realitzar la unitat formativa ”Bones pràctiques en el disseny de APIs i Linked Data” .
A continuació, la guia se centra en les pautes de disseny i implementació de APIs. Entre altres aspectes, s'aborda com usar URIs per a identificar recursos o com evitar ruptures de servici.
La guia acaba amb una sèrie d'apartats més específics centrats en la implementació de APIs en catàlegs de Datos Abiertos, per a l'accés a dades enllaçades i a servicis web geogràfics.
Quins són les principals novetats de l'actualització realitzada en 2025?
La guia ha sigut revisada en el 2025 per a actualitzar el contingut amb nous enllaços i exemples, a més d'ampliar el contingut sobre FIWARE amb un enfocament pràctic així com a aprofundir més detall per a la secció OpenAPI.
Un nou volum en la col·lecció
Esta guia forma part a una col·lecció de documents elaborats des de la Iniciativa Aporta per a ajudar als publicadors de dades a la hora de facilitar l'accés i impulsar l'ús de la informació publicada. En concret, la col·lecció busca donar a conéixer quins són els millors formats per a la reutilització, i facilitar una sèrie de pautes clares i senzilles que els organismes puguen seguir a l'hora de obrir les seues dataset, garantint així la qualitat dels mateixos.
La "Guia pràctica per a la publicació de Datos Abiertos usant APIs” és el segon nombre de la sèrie, que va començar en el mes de març amb la publicació de un primer volum dedicat a la publicació de dades tabulars en arxius CSV . En els pròxims mesos continuarem publicant continguts en el nostre afany per facilitar l'obertura de dades i la seua reutilització.
