Unha interface de programación de aplicacións ou API é un mecanismo que permite a comunicación e intercambio de información entre sistemas. As plataformas de datos abertos, como datos.gob.es
, contan con este tipo de ferramentas para interactuar co sistema de información e consultar os datos sen necesidade dun coñecemento da estrutura interna ou da tecnoloxía utilizada no seu desenvolvemento. Grazas a as APIs, os reutilizadores poden acceder máis facilmente a información que necesitan de forma automática, sendo posible axustar a descarga exclusivamente aos datos requiridos.
Cada vez son máis os organismos que aposta por este tipo de mecanismos, sobre todo para publicar datos con alta frecuencia de actualización como os datos en tempo real. A propia directiva europea de sobre datos abertos e reutilización da información do sector público refire a necesidade de contar con este tipo de mecanismos para a publicación de datos dinámicos e de alto valor. Es habitual usar APIs para acceder a datos meteorolóxicos, de transporte público ou os producidos por sensores de monitorización urbanos, aínda que cabe destacar que as APIs son adecuadas para consumir todo tipo de datos.
Co obxectivo de axudar a aqueles portais de datos abertos que aínda non conten cun API, desde datos.gob.es preparamos un guía coas principais pautas a seguir á hora de definir e pór en marcha este mecanismo de acceso aos datos.
Que pode atopar o lector nesta guía?
A Guía para a publicación de datos abertos utilizando APIs comeza cun primeiro apartado dedicado a entender que son as APIS e cal é o seu valor. En el explícase como funcionan e impleméntanse. Para aqueles que queiran ampliar a información, recoméndase realizar a unidade formativa ”Boas prácticas no deseño de APIs e Linked Data” .
A seguir, a guía céntrase nas pautas de deseño e implementación de APIs. Entre outros aspectos, abórdase como usar URIs para identificar recursos ou como evitar rupturas de servizo.
A guía acaba cunha serie de apartados máis específicos centrados en a implementación de APIs en catálogos de Datos Abiertos, para o acceso a datos enlazados e a servizos web xeográficos.
Cales son as principais novidades da actualización realizada en 2025?
A guía foi revisada no 2025 para actualizar o contido con novas ligazóns e exemplos, ademais de ampliar o contido sobre FIWARE cun enfoque práctico así como en profundar máis detalle para a sección OpenAPI.
Un novo volume na colección
Esta guía forma parte a unha colección de documentos elaborados desde a Iniciativa Achega para axudar aos publicadores de datos a a hora de facilitar o acceso e impulsar o uso da información publicada. En concreto, a colección busca dar a coñecer cales son os mellores formatos para a reutilización, e facilitar unha serie de pautas claras e sinxelas que os organismos poidan seguir á hora de abrir as súas dataset, garantindo así a calidade dos mesmos.
A "Guía práctica para a publicación de Datos Abiertos usando APIs” é o segundo número da serie, que comezou no mes de marzo coa publicación de un primeiro volume dedicado a a publicación de datos tabulares en arquivos CSV . Nos próximos meses continuaremos publicando contidos no noso afán por facilitar a apertura de datos e a súa reutilización.
