Développeur ? Géomaticien ? Client ? Curieux ? Venez découvrir les possibilités offertes par l’API Isogeo : principes, architecture technique, cas d’usage et retours d’expérience. La société PixUp présente notamment son utilisation de l’API pour le développement de portails Open Data

1. © 2016 Isogeo
WEBINAIRE ISOGEO
API v1
En lecture
19 janvier 2016

2. © 2015 Isogeo© 2016 Isogeo
Sommaire
Introduction – Julien MOURA, chef de projet Isogeo
Architecture technique – Mathieu Cartoixa, Directeur
technique
Processus de création d’application – Julien MOURA
Utilisation de l’API en live code – Antoine
AUDUSSEAU, développeur back-end
Développement de portail de données – Emmanuel
Guerin, PixUP
Série de questions-réponses?

3. © 2016 Isogeo
ARCHITECTURE TECHNIQUE
Mathieu CARTOIXA

4. © 2015 Isogeo© 2016 Isogeo
Architecture
• RESTful https://en.wikipedia.org/wiki/Representational_state_transfer#Applied_to_web_services
– Basée sur les technologies standards du web
• Protocole HTTP https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
• Verbes standard (GET, PUT, POST, DELETE…)
• 1 ressource = 1 URL
• JSON https://en.wikipedia.org/wiki/JSON
– Utilisation indépendante des langages
• Javascript, .NET, Java, PHP, Ruby…
• Sécurité
– Authentification OAuth 2.0 http://oauth.net/2/
– Fair use

5. © 2015 Isogeo© 2016 Isogeo
Plateforme Isogeo
• En production depuis juin 2012
• Hébergée sur Microsoft Azure
– Backend : .NET + SQL Azure
– Frontend : Javascript + node.js
• API
– Les applications Isogeo utilisent l’API Isogeo
– 2ème version interne
– 1ère version publique
• En lecture seule
• Réservée aux applications (pas de connexion utilisateur)
– Client Credentials Grant http://tools.ietf.org/html/rfc6749#section-4.4
• Stable

6. © 2015 Isogeo© 2016 Isogeo
Plateforme Isogeo
Isogeov1.api.isogeo.com
id.api.isogeo.com
App
OpenCatalog
JSON
JSON

7. © 2015 Isogeo© 2016 Isogeo
Plateforme Isogeo
Isogeov1.api.isogeo.com
id.api.isogeo.com
App
OpenCatalog
JSON
JSON
JSON
JSON

8. © 2015 Isogeo© 2016 Isogeo
Application
• Déclarée sur la plateforme Isogeo
– Identifiants OAuth 2.0
– Associée à des groupes de travail
• Accède aux données qui lui sont partagées
– Via un access token http://tools.ietf.org/html/rfc6749#section-1.4

9. © 2015 Isogeo© 2016 Isogeo
Développement
• Documentation
https://docs.google.com/document/d/11dayY1FH1NETn6mn9Pt2y3n8ywVUD0DoKbCi9ct9ZRo/edit?usp=sharing
• OAuth 2.0
– Utiliser des bibliothèques existantes http://oauth.net/2/#client-libraries
– Protéger secrets et tokens
• Via un proxy
• Pas d’appels Cross Origin

10. © 2015 Isogeo© 2016 Isogeo
À suivre
• Portail développeur
– Gestion des applications par les développeurs
– Documentation interactive
• Description Swagger http://swagger.io/
• Travail en cours http://v1.api.isogeo.com/swagger.json
• API v2
– Ecriture ?
– Simplification du modèle ?

11. © 2016 Isogeo
PROCESSUS DE CRÉATION
D’APPLICATIONS
Julien MOURA

12. © 2016 Isogeo
UTILISATION DE L’API EN LIVE CODE
Antoine AUDUSSEAU

13. © 2016 Isogeo
DÉVELOPPEMENT DE PORTAIL DE
DONNÉES
Emmanuel GUERIN

14. © 2015 Isogeo© 2016 Isogeo
Lien utile
• Accès sur Github aux fichiers de la démo :
https://gist.github.com/pixup/f050f3c1c55ca632f0c9

15. © 2016 Isogeo

16. © 2016 Isogeo