Swagger / JS Meetup 5 mars 2015
©EPFL
Qui êtes vous ?
→ Qui crée des APIs ?
→ Qui consomme des API
→ Combien d’API avez vous utilisées
aujourd’hui ?
Pierre-André Vullioud
watchful.li CTO
Owner of inetis.ch
Joomla enthusiast
@pavullioud
APIs in 2015
source : www.programmableweb.com/api-research
Amazon
→ All teams will expose their data and functionality
through API.
→ There will be no other form of interprocess
com...
API centric architecture
→ Internal use
→ Apps
→ Clients
→ Partners
Data
API
Functionality
app
partners
services
Swagger
Language pour décrire des API REST
http://swagger.io/
Description de votre API
JSON
Technologie agnostique
Accélère le développement
Documentation
https://watchful.li/apidoc-v1/index.html
SDK Generator
https://github.com/swagger-api/swagger-codegen
Javascript
Javascript Class
https://github.com/wcandillon/swagger-js-codegen
Générer dynamiquement un client en Javascript...
Client dynamique
var swagger = new client.SwaggerClient({
url: 'http://petstore.swagger.wordnik.com/v2/swagger.json',
succ...
Editeur
http://editor.swagger.io/#/
Générer le code
→ avec l’éditeur
→ parser le code source
Exemple PHP
https://github.com/zircote/swagger-php/
Questions ?
Prochain SlideShare
Chargement dans…5
×

Swagger, language pour décrire des API REST

1 562 vues

Publié le

Format JSON
Technologie agnostique
Accélère le développement

Présentation donnée le 5 mars dans le cadre de JS Romandie, Meetup

Publié dans : Internet
0 commentaire
3 j’aime
Statistiques
Remarques
  • Soyez le premier à commenter

Aucun téléchargement
Vues
Nombre de vues
1 562
Sur SlideShare
0
Issues des intégrations
0
Intégrations
9
Actions
Partages
0
Téléchargements
24
Commentaires
0
J’aime
3
Intégrations 0
Aucune incorporation

Aucune remarque pour cette diapositive

Swagger, language pour décrire des API REST

  1. 1. Swagger / JS Meetup 5 mars 2015 ©EPFL
  2. 2. Qui êtes vous ? → Qui crée des APIs ? → Qui consomme des API → Combien d’API avez vous utilisées aujourd’hui ?
  3. 3. Pierre-André Vullioud watchful.li CTO Owner of inetis.ch Joomla enthusiast @pavullioud
  4. 4. APIs in 2015 source : www.programmableweb.com/api-research
  5. 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. 6. API centric architecture → Internal use → Apps → Clients → Partners Data API Functionality app partners services
  7. 7. Swagger Language pour décrire des API REST http://swagger.io/
  8. 8. Description de votre API JSON Technologie agnostique Accélère le développement
  9. 9. Documentation https://watchful.li/apidoc-v1/index.html
  10. 10. SDK Generator https://github.com/swagger-api/swagger-codegen
  11. 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. 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. 13. Editeur http://editor.swagger.io/#/
  14. 14. Générer le code → avec l’éditeur → parser le code source
  15. 15. Exemple PHP https://github.com/zircote/swagger-php/
  16. 16. Questions ?

×