Lors du meetup swagger/js du 5 mars 2015, des experts ont discuté de l'importance croissante des API dans le développement de logiciels, citant Amazon comme un exemple essentiel d'architecture centrée sur les API. La présentation a également mis en avant Swagger, un outil pour décrire et documenter des APIs REST de manière agnostique, facilitant ainsi le développement et l'intégration. Des ressources et liens vers des générateurs de code SDK et éditeurs Swagger ont été partagés pour encourager l'adoption de cette technologie.

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 ?