¡Colabora con nosotros!

API para programadores

Introducción

El proyecto tuderechoasaber.es funciona de acuerdo con los principios de los datos abiertos, disponibles para los programadores que quieran utilizarlos en otros sitios web y software.

tuderechoasaber.es todavía no tiene un API completo pero vamos gradualmente añadiendo una gran cantidad de cosas que semejan en el uso a un API, según requieren los programadores.

Enlaces a nuevas solicitudes

Para animar tus usuarios a entrar en contacto con una autoridad pública específica utiliza URLs de la forma:

http://www.tuderechoasaber.es/es/new/ministerio_de_sanidad

Estos son los parámetros que puedes añadir a las URLs, bien en la URL en sí, bien desde un formulario:

  • title - título predefinido de la nueva solicitud.
  • default_letter - texto predefinido del cuerpo de la carta. La formula de encabezamiento (Querido...) y la despedida (Un saludo...) se añadirán al comienzo y al final.
  • body - en alternativa a default_letter esto pone como predefinido el texto entero de la solicitud dejándote la posibilidad de personalizar el saludo y la despedida.
  • tags - lista de etiquetas separadas con espacios, para que puedas buscar y enlazar posteriormente a las solicitudes realizadas, p.ej. openlylocal spending_id:12345. Los dos puntos (:) indican que la etiqueta contiene un valor ('machine tag'), que puede incluir puntos.

Feeds RSS (en realidad, Atom)

En la mayoría de las páginas que incluyen solicitudes de acceso a la información hay feeds Atom que puedes utilizar para obtener actualizaciones y enlaces en formato XML. Puedes encontrar el URL del feed Atom con una de las siguientes opciones:

  • Busca el enlace al feed RSS.
  • Examina la declaración <link rel="alternate" type="application/atom+xml"> en la cabecera del código HTML.
  • Añade /feed al final de la URL.

En particular, incluso las búsquedas avanzadas soportan feeds en formato Atom. Puedes hacer todo tipo de cosa con este formato, como consultas por autoridad, por tipo de archivo, por fecha o por estado. Para más detalles véase los consejos de la búsqueda avanzada.

Datos estructurados en JSON

Bastantes páginas tienen una versión JSON que permite bajar informaciones sobre los objetos en una forma estructurada. Para encontrarlos:

  • Añade .json al final de la URL.
  • Busca la declaración <link rel="alternate" type="application/json"> en la cabecera del código HTML.

Solicitudes, usuarios y autoridades, todos tienen una versión JSON con informaciones básicas sobre ellos. Cada formato Atom tiene un equivalente JSON con informaciones sobre los objetos incluidos en el feed.

Información sobre todos los organismos públicos de España

Un fichero CSV con información sobre todos los organismos de España está disponible en el sitio web de tuderechoasaber.es: all-authorities.csv

Por favor contáctanos si necesitas funcionalidad en el API que todavía no esté aquí. Es un trabajo en proceso, y añadimos cosas cuando la gente nos lo pide.