wiki:Metanol/Integration/Json

Version 1 (modified by http://emmanuel.raviart.myopenid.com/, 12 years ago) (diff)

Ajout de l'intégration par JSON

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

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": {
            "name": "Annuaire de l'administration",
            "url": "http://annuaire.infos-pratiques.org/?commune=75014%20Paris%2014e%20Arrondissement"
        },
        "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 ajoutant dans une page web, la liste de toutes les administrations ayant le mot-clé "Administration générale" :

TODO

Résultat :

TODO