Aragón Open Data, portal de datos abiertos del Gobierno de Aragón, estrenará a partir del día 27 de octubre de 2021 nueva versión del servicio GA_OD_Core, API (Interfaz de Programación de Aplicaciones) de nuestro portal de datos abiertos, con la finalidad de dar la capacidad a los ciudadanos y desarrolladores de obtener acceso a los datos ofrecidos actualmente a través del portal Aragón Open Data, y poder integrarlos en diferentes aplicaciones y servicios mediante el uso de la arquitectura REST (Transferencia de Estado Representacional)

Esta versión mejora la funcionalidad y la seguridad de la API anterior, lo que supone un avance significativo en la evolución continua que se está acometiendo del ecosistema tecnológico de Aragón Open Data.

Aunque se ha mantenido las funcionalidades principales de la anterior versión del GA_OD_Core, los cambios incorporan otras funcionalidades extras, por ejemplo:

• Además de seguir exponiendo bases de datos mediante el uso de vistas, la versión incorpora la capacidad de obtener datos directamente de otras APIs externas.
• Se han modificado el formato de salida de las peticiones de recursos en JSON y CSV (el separador ahora es el caracter “,”) con el objetivo de seguir los estándares y tener mayor interoperabilidad. A continuación se muestra un ejemplo de salida de cada uno de ellos.

JSON:

CSV:

• Adicionalmente a los formatos que ya se exponían antes (concretamente: CSV, JSON, XML), se añade la capacidad de obtener datos en formato XLS (excel) para favorecer su uso.

También, a parte de las funcionalidades mencionadas, la API incorpora mejoras que optimizan su desempeño en materia de seguridad y rendimiento de la herramienta:

• Se ha cambiado el método para la incorporación de vistas y conexiones a bases de datos, haciendo que su gestión se realice de manera más sencilla.
• Se proporciona la capacidad de integrar terceras aplicaciones a la API, siempre con la debida autorización.
• Se capacita la integración de APIs externas, para su integración en el ecosistema de Aragón Open Data y su apertura al usuario final en el catálogo de datos.
• Mediante esta versión se aumenta la seguridad del sistema que es una de las principales mejoras, ya que se han incorporado medidas para evitar actos que puedan desestabilizar la plataforma; como por ejemplo SQL injection (que pueda saturar las peticiones), ataques de fuerza bruta, etc.

Importante:

Todas las URLs que se incluyen y los ejemplos de uso de este contenido serán habilitadas con el despliegue del póximo GA_OD_CORE el día 27 de octubre de 2021.  Hasta finales de año se mantendrá disponible la anterior versión en  https://opendata.aragon.es/GA_OD_Core_legacy/ui  fecha que se eliminará definitivamente.  Ajuste sus peticiones y consultas al servicio para mantenerlo operativo y para cualquier aclaración o detalle diríjase al correo de contacto: opendata@aragon.es

La versión la API se encuentra en el siguiente enlace (ejemplos disponibles desde el 27 de octubre de 2021): https://opendata.aragon.es/GA_OD_Core/ui/

Ejemplos de uso del GA_OD_Core

A continuación, se desarrollan ejemplos de usos concretos de la API.

• Método “views”:  lista de recursos públicos que dispone GA_OD_Core.

La llamada sería la siguiente: https://opendata.aragon.es/GA_OD_Core/views 

• Método “download”: descarga del recurso seleccionado.

La llamada se haría de la siguiente manera: https://opendata.aragon.es/GA_OD_Core/download?resource_id={resource_id}

Por ejemplo, si se quisiese descargar los datos correspondientes a la vista de municipios de Aragón (id de vista 11, “Datos Municipio”), lo haríamos de la siguiente manera: https://opendata.aragon.es/GA_OD_Core/download?resource_id=11 

Para descargar este recurso en un formato en formato ‘xlsx’ (Excel) se haría de la siguiente manera (también se puede en ‘xml’, ‘json’ y ‘csv’): https://opendata.aragon.es/GA_OD_Core/download?resource_id=11&formato=xlsx

• Método “preview”: previsualización de los datos del recurso seleccionado.

El esquema de la llamada sería el siguiente: https://opendata.aragon.es/GA_OD_Core/preview?resource_id={view_id}

Por ejemplo, si se quisiese previsualizar los datos de municipios, lo haríamos de la siguiente manera: https://opendata.aragon.es/GA_OD_Core/preview?resource_id=11

Igualmente, si quisiésemos previsualizar el recurso en formato Excel: https://opendata.aragon.es/GA_OD_Core/preview?resource_id=11&formato=xlsx

• Parámetro “filter”: parámetro de los métodos download y preview para filtrar los datos del recurso, a través de la selección mediante diferentes condiciones categóricas.

Si por ejemplo queremos previsualizar sólamente los municipios pertenecientes a la provincia de Teruel, filtraremos la anterior consulta proporcionando en el parámetro “filter” del swagger la siguiente condición en formato {“clave”:”valor”}:

{"provincia": "TERUEL"}

En definitiva, la URL para hacer la consulta sería la siguiente: https://opendata.aragon.es/GA_OD_Core/preview?resource_id=11&filters=%7B%22provincia%22%3A%20%22TERUEL%22%7D

• Api “transports”

Por último, la API GA_OD_Core incorpora en esta versión diferentes endpoints que permiten obtener datos de dos APIs diferentes con datos de transportes de autobús del ámbito de Zaragoza (opendata.aragon.es/GA_OD_Core/gaodcore-transports/zaragoza/{método}) y de Aragón (opendata.aragon.es/GA_OD_Core/gaodcore-transports/aragon/{método}).

Por ejemplo, en el caso de que queramos consultar la geolocalización de los autobuses de Zaragoza podríamos llamar al siguiente endpoint: