Ayuda

Contáctanos

Si tu pregunta no está resuelta aquí, o quieres hacernos llegar algún comentario sobre la web, contáctanos.

API para programadores

Introducción

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

derechoapreguntar.org 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 entidad pública específica utiliza URLs de la forma:

https://derechoapreguntar.org/new/ministerio_de_trabajo

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 todas las entidades públicas de Nicaragua

Un fichero CSV con información sobre todas las entidades públicas de Nicaragua está disponible en el sitio web de derechoapreguntar.org: 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.