Info Open Data

Todo lo necesario para entender Aragón Open Data

Desarrolladores




CREDENCIALES



Necesidad de credenciales

Para obtener resultados de esta API, es necesario proporcionar a las llamadas un parámetro con una credencial (api_key). Esta api_key se puede obtener de forma gratuita mediante el registro como usuario de la página 3scale.net


Por el momento, se ofrece la posibilidad de utilizar una api_key genérica y compartida, si bien en el futuro podría ser necesario el registro individualizado de todos los usuarios.


En el caso de que seas un desarrollador que vaya a hacer un uso intensivo de este servicio, rogamos contactes con nosotros a través de opendata@aragon.es para proporcionarte una api_key individualizada para tus desarrollos.


 


TIPOS DE LLAMADA



Listados

Para obtener la lista de entidades territoriales hay que llamar a la API de la siguiente manera:



Donde api_key puede tomar o bien el valor de tu clave cifrada de usuario, o bien la clave genérica que es:

e103dc13eb276ad734e680f5855f20c6

Además, es posible añadir un parámetro adicional, de nombre _view que servirá para obtener más o menos grado de detalle para cada elemento. Este parámetro opcional _view puede tomar los siguientes valores:

  • simple: obtener sólo la lista de elementos detalles básicos. Es la opción por defecto, si no se indica.
  • ampliada: obtener todos los detalles posibles, con referencias a los datos estadísticos disponibles para el elemento
  • completa: obtener todos los detalles posibles, incluyendo no sólo las referencias a los datos estadísticos, sino también los valores de estas observaciones
 

Búsquedas

Para obtener una de las entidades territoriales hay que añadir a las llamadas anteriores el signo de dividir '/' seguido del identificador de la entidad a buscar.


Para conseguir el valor exacto de los identificadores que debes usar para referirte a cada entidad territorial, puedes consultar el resultado de las llamadas anteriores del apartado Listados.


Del mismo modo que antes, hay que proporcionar la api_key y se puede indicar el tipo de vista (_view).


Así por ejemplo, para obtener los detalles del municipio Tauste (Comarca Cinco Villas, provincia de Zaragoza, Comunidad Autónoma de Aragón) se realizarían las siguientes consultas:


 

Listado de observaciones

Para obtener el listado de observaciones hay que realizar la consulta a:


http://opendata.aragon.es/recurso/estadistica/Observacion?api_key={tu API KEY}



Del mismo modo que antes, hay que proporcionar la api_key y se puede indicar el tipo de vista (_view).

 

Formatos

Todas las peticiones anteriores pueden devolver el resultado en varios formatos. Para ello, hay que indicar el tipo de respuesta deseada, precedida por punto, al final de la URI y justo antes de los parámetros.


Del mismo modo que antes, hay que proporcionar la api_key y se puede indicar el tipo de vista (_view).


Los formatos disponibles son:

  • .csv
  • .html
  • .json
  • .rdf
  • .ttl
  • .xml

Así por ejemplo, para obtener la información del municipio Albarracín en formato JSON quedaría así:


http://opendata.aragon.es/recurso/territorio/Municipio/Albarracín.json?api_key={tu API KEY}