testeur Winform C# de l’API de la ville de Paris

UPDATE 2015 MAY 2 : nouvelle version qui fonctionne avec les dernières API
+ rendu HTML des résultats JSON
requetes
lien de téléchargement du binaire (clickonce)  : http://legacy.averbouch.biz/wp-content/ParisAPITester/publish.htm

remarque: cette version « clickonce » peut être désinstallée via le panneau de configuration/ ajout /suppresion de programmes :

nom du programme : testopendata
parisapitester


La ville de Paris a récemment lancé son API (interface de programmation applicative) pour pouvoir accéder à des nombreuses données ouvertes (« open data ») que possède la ville.

J’ai réalisé un petit testeur de l’API, en C#

J’ai utilisé des composants open source, notamment pour « parser » le Json et générer son schéma (liens : Json.Net , Xamasoft Json class generator, et également ce lien)

Pour pouvoir l’utiliser, il faut :

– le framework .Net 4.5 (disponible ici: http://www.microsoft.com/fr-fr/download/details.aspx?id=30653 )

– un « jeton » (token) pour pouvoir utiliser l’API, gratuitement disponible en s’inscrivant sur le site dédié de la ville de Paris : https://api.paris.fr/

cette petite application affiche une liste de requêtes disponibles

une fois une requête sélectionnée, vous pouvez éditer ses paramètres dans la case en dessous (le nombre et les valeurs des paramètres dépendent de la requête sélectionnée)

l’application parcourt la réponse du serveur (en Json) et affiche les résultats en dessous : statut, message et les données de réponse.

Le schéma Json (généré à  partir des données de réponse) est également affiché.

Remarque: pour ne pas avoir à recopier votre « token » à chaque fois, vous pouvez l’insérer dans le fichier de configuration de l’application: (le fichier se nomme « testOpenData.exe.config »).

Le jeton est à insérer entre les deux guillemets après tokenHelp

En modifiant la requête affichée (ou bien en modifiant les requêtes dans ce fichier de configuration), vous pouvez en fait tester n’importe quelle API qui renvoie du JSON  (JavaScript Object Notation)

copie d’écran (mon jeton d’accès est volontairement grisé)

Paris API Tester

Paris API Tester

pour télécharger le binaire de l’application : lien –> ParisAPItester.zip

(Extraire le fichier zippé dans le dossier de votre choix et dans ce dossier, lancer « testOpenData » (ou « testOpenData.exe » si vous avez activé l’option d’affichage des extensions de fichier)