Información para desarrolladores

API

¿Qué Sabés? cuenta con una API externa realizada en PHP para exportar datos de las búsquedas.

Para consumir el servicio:

URL: quesabes.org/export.php
method="get"
option: String -> "export"
id: String -> all / ID Solicitud
state: String -> all / successful / user_withdrawn / not_held / internal_review / gone_postal / unsatisfactory_response / waiting_response / partially_successful / rejected
query: String
date_after: String -> dd/mm/yyyy
date_before: String -> dd/mm/yyyy
format: String -> "csv" / "ods" / "xml"

Enlaces a nuevas solicitudes

Para ir directo al formulario de envío de una solicitud en un organismo específico, las URLs deben tener éste formato:

https://quesabes.org/new/nombre_de_organismo

Y se le pueden añadir siguientes los parámetros en la URL en sí o 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 se pueden usar para obtener actualizaciones y enlaces en formato XML. Se puede encontrar el URL del feed Atom con una de las siguientes opciones:

• Buscar enlazando al feed RSS.
• Examinar la declaración <link rel="alternate" type="application/atom+xml"> en la cabecera del código HTML.
• Añadir /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 ver los consejos de la búsqueda avanzada.

Datos estructurados en JSON

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

• Añadí .json al final de la URL.
• Buscá 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 información básica sobre ellos. Cada formato Atom tiene un equivalente JSON con información sobre los objetos incluidos en el feed.

Información sobre todos los organismos en ¿Qué Sabés?

Un archivo CSV con información sobre todos los organismos de Uruguay está disponible en el sitio: all-authorities.csv

Por favor contáctanos si necesitas funcionalidad en el API que todavía no esté.