À propos de notre API

Introduction

Cette page explique comment les programmeurs peuvent faire interagir d'autres sites web et logiciels avec Ma Dada via une "API".

Ma Dada n'a pas d'API complète pour l'instant, mais nous ajoutons graduellement des éléments dont l'usage se rapproche de celui d'une API. Cette page sera prochainement traduite en français.

Lien vers les nouvelles requêtes

Afin d'encourager les utilisateur.rice.s à faire des liens vers les demandes adressées à une autorité adiministrative en particulier, utilisez les URL sous la forme /nouvelle_demande/liverpool_city_council. Les paramètres ci-dessous peuvent être ajoutés à vos URL, soit dans l'URL soit dans le formulaire.

• title - résumé par défaut de la nouvelle requête.
• default_letter - texte par défaut du corps de la demande. La formule de politesse d'introduction (Chère...) et de salutation (Veuillez...) sont intégrées à l'intérieur.
• body - il s'agit d'une alternative à default_letter, qui fournit le texte entier de la demande, de manière à vous laisser la possibilité de modifier les formules de politesse.
• tags - liste séparé par des virgules des mots-clés, vous permettant de trouver et de lier aux demandes en cours et à venir associées à ces mots-clés, par exemple autorités-locales spending_id:12345. les : indiquent qu'il s'agit d'un mot-clé fourni par le logiciel. Les valeurs des mots-clés fournis par le logiciel peuvent inclure des :, utiles pour les URIs.

Flux RSS (Atom)

Des flux Atom sont disponibles sur la plupart de pages qui listent les demandes d'accès à l'information, que vous pouvez utiliser pour être tenus au courant des mises à jour de la demande au format XML. Pour trouver le lien du flux Atom il existe 2 possibilités :

• Recherchez l'icône des flux RSS.
• Examine le code <link rel="alternate" type="application/atom+xml"> dans le header du code HTML.
• Ajoutez /feed au début d'une URL.

En particuler, même les requêtes complexes disposent de liens RSS. Vous pouvez faire plein de choses diffférentes avec ces liens, comme rechercher par autorité, par type de fichier, par plage de date, ou par status. Consultez la page d'aide sur la recherche avancée pour plus de détails.

Données strucutées en JSON

Un certains nombre de page disposent d'une version JSON, qui vous permettent de télécharger des informations which let you download information sous le forme d'objets structurés. Pour les trouver :

• Ajouter .json à la fin de l'URL.
• Regarder le <link rel="alternate" type="application/json"> dans les en-têtes du code HTML.

Requêtes, utilisateurs et autorités disposent tous d'une version JSON contenant des informations basiques les concernant. Chaque flux Atom à son équivalent JSON, contenant des informations sur la liste des évènements du flux.

Liste des autorités

Un fichier contenant la liste des autorités publiques du site Ma Dada est disponible ici: all-authorities.csv

5. API en écriture

L'API en écriture est destinée aux autorités pour leur permettre de créer leurs proposes requêtes sur la plateforme. Cette API est actuellement utilisée par le logiciel de mySociety afin d'utiliser Alaveteli comme un registre de traitement de l'ensemble de l'activité de demande d'accès à l'information concernant une autorité publiques particulière. Plus d'informations techniques concernant l'API en écriture est disponible sur le wiki d'Alaveteli .

Merci de nous contacter si vous avez besoin d'une fonctionnalité qui n'est pas encore disponible.