wiki:Metanol/Integration/Json

Intégration de Metanol par web-service au format JSON

OBSOLÈTE

Cette documentation est obsolète depuis la version 0.3 de Metanol. L'API JSON n'est pas stabilisée pour le moment.

OBSOLÈTE

En plus du HTML, Metanol publie les données de du méta-annuaire de l'administration au format JSON.

Ce web-service rend possible des usages de ces données comme par exemple :

  • intégration dans un site par des appels serveurs à ce web-service ;
  • intégration dans un site par JavaScript.

Accès au web-service

Le web-service est disponible à l'URL http://annuaire.infos-pratiques.org/json en lui fournissant comme paramètre :

  • commune : code postal et nom de la commune

Le format JSON utilisé est présenté dans le premier exemple ci-dessous.

Exemples d'utilisation du web-service

Exemple d'appel du web-service

Exemple récupérant les informations des administrations compétentes sur le 14e arrondissement de Paris :

  • Requête : http://annuaire.infos-pratiques.org/json?commune=75014%20Paris%2014e%20Arrondissement
  • Réponse :
    {
        "organisms": {
            "cdg": {
                "url": "http://lannuaire.service-public.fr/navigation/paris_cdg.html",
                "acronym": "CDG",
                "name": "Centre de gestion de la fonction publique territoriale",
                "tags": ["Administration", "Fonction publique"]
            },
            "tribunal_commerce": {
                "url": "http://www.justice.gouv.fr/recherche-juridictions/consult.php?insee=75114",
                "acronym": null,
                "name": "Tribunal de commerce",
                "tags": ["Administration", "Droit, justice"]
            },
            "ddaf": {
                "url": "http://lannuaire.service-public.fr/navigation/paris_ddaf.html",
                "acronym": "DDAF", 
                "name": "Direction départementale de l'agriculture et de la forêt", 
                "tags": ["Administration", "Agriculture"]
            },
            ...
        },
        "territory": {
            "name": "Paris 14e Arrondissement"
            "postal_code": "75014"
        },
        "source": {
            "date": "2009-02-01T18:27:44.779198",
            "name": "Annuaire de l'administration",
            "url": "http://annuaire.infos-pratiques.org/?commune=75014+Paris+14e+Arrondissement"
        },
        "license": {
            "name": "GNU Free Documentation License version 1.3 ou supérieure",
            "url": "http://www.gnu.org/copyleft/fdl.html"
        },
        "producer": {
            "name": "Metanol",
            "url": "http://wiki.infos-pratiques.org/wiki/Metanol"
        },
    }
    

Exemple JavaScript

Exemple JavaScript ajoutant dans une page web, la liste de toutes les administrations compétentes sur Montpellier ayant le mot-clé "Administration générale" (cet exemple utilise la biblitothèque JavaScript jQuery, afin de rester relativement concis) :

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.3.1/jquery.min.js"></script>
<ul id="administration-generale-montpellier"></ul>
<script type="text/javascript">
$.getJSON(
    'http://annuaire.infos-pratiques.org/json?commune=34000+Montpellier&jsonp=?',
    function(data) {
        $.each(data.organisms, function(pivot_code, organism) {
            if ($.inArray("Administration générale", organism.tags) >= 0)
                $("<li/>").append($("<a/>").attr("href", organism.url).text(organism.name)).appendTo(
                    "#administration-generale-montpellier");
        });
    }
);
</script>

Résultat :

    Last modified 9 years ago Last modified on Mar 9, 2009, 4:14:56 PM