Swagger, language pour décrire des API REST
4 j'aime2,834 vues
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.
![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/](https://image.slidesharecdn.com/swagger-150306025002-conversion-gate01/85/Swagger-language-pour-decrire-des-API-REST-5-320.jpg)
Swagger, language pour décrire des API REST
- 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
- 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}); } });
- 14. Générer le code → avec l’éditeur → parser le code source
- 16. Questions ?