Format JSON Technologie agnostique Accélère le développement Présentation donnée le 5 mars dans le cadre de JS Romandie, Meetup

1. Swagger / JS Meetup 5 mars 2015
©EPFL

2. Qui êtes vous ?
→ Qui crée des APIs ?
→ Qui consomme des API
→ Combien d’API avez vous utilisées
aujourd’hui ?

3. Pierre-André Vullioud
watchful.li CTO
Owner of inetis.ch
Joomla enthusiast
@pavullioud

4. APIs in 2015
source : www.programmableweb.com/api-research

5. Amazon
→ All teams will expose their data and functionality
through API.
→ There will be no other form of interprocess
communication [..]
→ Anyone who doesn't do this will be fired.
Amazon policy set by Jeff Bezos in 2003
http://apievangelist.com/2012/01/12/the-secret-to-amazons-success-internal-apis/

6. API centric architecture
→ Internal use
→ Apps
→ Clients
→ Partners
Data
API
Functionality
app
partners
services

7. Swagger
Language pour décrire des API REST
http://swagger.io/

8. Description de votre API
JSON
Technologie agnostique
Accélère le développement

9. Documentation
https://watchful.li/apidoc-v1/index.html

10. SDK Generator
https://github.com/swagger-api/swagger-codegen

11. Javascript
Javascript Class
https://github.com/wcandillon/swagger-js-codegen
Générer dynamiquement un client en Javascript
https://github.com/swagger-api/swagger-js

12. Client dynamique
var swagger = new client.SwaggerClient({
url: 'http://petstore.swagger.wordnik.com/v2/swagger.json',
success: function() {
swagger.apis.pet.getPetById({petId:1});
}
});

13. Editeur
http://editor.swagger.io/#/

14. Générer le code
→ avec l’éditeur
→ parser le code source

15. Exemple PHP
https://github.com/zircote/swagger-php/

16. Questions ?