Ce diaporama a bien été signalé.
Nous utilisons votre profil LinkedIn et vos données d’activité pour vous proposer des publicités personnalisées et pertinentes. Vous pouvez changer vos préférences de publicités à tout moment.
REST	
  APIs	
  
dokumentieren	
  mit	
  
Swagger
Daniel	
  Pozzi,	
  FrOSCon 2015
Über	
  Swagger und	
  mich
2
https://github.com/bonndan https://swagger.io/
Apache	
  2	
  license
APIs	
  für	
  Nicht-­‐EntwicklerSwagger-­‐UI
3
Demo	
  (swagger-­‐demo	
   starten):
http://localhost:8080/docs/index.htm...
4
Das	
  Herzstück:	
  die	
  
JSON	
  Spezifikation
5
Aus	
  dem	
  Demo:
https://goo.gl/If4I2t
Swagger Workflow
6
JSON
Spezifikation
HTML	
  API	
  UI
SDK	
  Generierung
Code
Annotation
Swagger Annotations
7
Swagger Annotations
https://github.com/swagger-­‐api/swagger-­‐core/wiki/Annotations-­‐1.5.X
Für	
  ...
SDK	
  Generierung
8
Beispiel	
  für	
  PHP	
  und	
  Java:
https://github.com/leanix/swagger-­‐demo-­‐codegen
Konfigurati...
Swagger nutzt	
  Mustache
9
Code:
https://goo.gl/cdlXKl
Java	
  und	
  
Swagger
Maven Swagger Plugin statt	
  
Scala	
  Runtime!
10
https://github.com/leanix/swagger-­‐demo/blob/...
Tricks	
  und	
  Fallen
11
• Vorsicht	
  mit	
  Enums in	
  Swagger V1
• Map-­‐artige	
  Typen	
  erfordern	
  Handarbeit
...
Referenzen und	
  mehr
12
Mehr:	
  
http://swagger.io/open-­‐source-­‐integrations/
Code:
https://github.com/leanix/swagge...
Prochain SlideShare
Chargement dans…5
×

LeanIX Swagger REST API @ Open Source Konferenz FrosCon, Sankt Augustin

2 835 vues

Publié le

Presentation von LeanIX Entwickler Daniel Pozzi bei der Open Source Konferenz FrosCon 2015 in Sankt. Augustin.
===
LeanIX offers an innovative software-as-a-service solution for Enterprise Architecture Management (EAM), based either in a public cloud or the client’s data center.

Companies like Adidas, Axel Springer, Helvetia, RWE, Trusted Shops and Zalando use LeanIX Enterprise Architecture Management tool.

Free Trial: http://bit.ly/LeanIXDemoS

Publié dans : Logiciels
  • DOWNLOAD THIS BOOKS INTO AVAILABLE FORMAT (Unlimited) ......................................................................................................................... ......................................................................................................................... Download Full PDF EBOOK here { https://soo.gd/qURD } ......................................................................................................................... Download Full EPUB Ebook here { https://soo.gd/qURD } ......................................................................................................................... Download Full doc Ebook here { https://soo.gd/qURD } ......................................................................................................................... Download PDF EBOOK here { https://soo.gd/qURD } ......................................................................................................................... Download EPUB Ebook here { https://soo.gd/qURD } ......................................................................................................................... Download doc Ebook here { https://soo.gd/qURD } ......................................................................................................................... ......................................................................................................................... ................................................................................................................................... eBook is an electronic version of a traditional print book THIS can be read by using a personal computer or by using an eBook reader. (An eBook reader can be a software application for use on a computer such as Microsoft's free Reader application, or a book-sized computer THIS is used solely as a reading device such as Nuvomedia's Rocket eBook.) Users can purchase an eBook on diskette or CD, but the most popular method of getting an eBook is to purchase a downloadable file of the eBook (or other reading material) from a Web site (such as Barnes and Noble) to be read from the user's computer or reading device. Generally, an eBook can be downloaded in five minutes or less ......................................................................................................................... .............. Browse by Genre Available eBooks .............................................................................................................................. Art, Biography, Business, Chick Lit, Children's, Christian, Classics, Comics, Contemporary, Cookbooks, Manga, Memoir, Music, Mystery, Non Fiction, Paranormal, Philosophy, Poetry, Psychology, Religion, Romance, Science, Science Fiction, Self Help, Suspense, Spirituality, Sports, Thriller, Travel, Young Adult, Crime, Ebooks, Fantasy, Fiction, Graphic Novels, Historical Fiction, History, Horror, Humor And Comedy, ......................................................................................................................... ......................................................................................................................... .....BEST SELLER FOR EBOOK RECOMMEND............................................................. ......................................................................................................................... Blowout: Corrupted Democracy, Rogue State Russia, and the Richest, Most Destructive Industry on Earth,-- The Ride of a Lifetime: Lessons Learned from 15 Years as CEO of the Walt Disney Company,-- Call Sign Chaos: Learning to Lead,-- StrengthsFinder 2.0,-- Stillness Is the Key,-- She Said: Breaking the Sexual Harassment Story THIS Helped Ignite a Movement,-- Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones,-- Everything Is Figureoutable,-- What It Takes: Lessons in the Pursuit of Excellence,-- Rich Dad Poor Dad: What the Rich Teach Their Kids About Money THIS the Poor and Middle Class Do Not!,-- The Total Money Makeover: Classic Edition: A Proven Plan for Financial Fitness,-- Shut Up and Listen!: Hard Business Truths THIS Will Help You Succeed, ......................................................................................................................... .........................................................................................................................
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • DOWNLOAD THAT BOOKS INTO AVAILABLE FORMAT (2019 Update) ......................................................................................................................... ......................................................................................................................... Download Full PDF EBOOK here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download Full EPUB Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download Full doc Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download PDF EBOOK here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download EPUB Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download doc Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... ......................................................................................................................... ................................................................................................................................... eBook is an electronic version of a traditional print book that can be read by using a personal computer or by using an eBook reader. (An eBook reader can be a software application for use on a computer such as Microsoft's free Reader application, or a book-sized computer that is used solely as a reading device such as Nuvomedia's Rocket eBook.) Users can purchase an eBook on diskette or CD, but the most popular method of getting an eBook is to purchase a downloadable file of the eBook (or other reading material) from a Web site (such as Barnes and Noble) to be read from the user's computer or reading device. Generally, an eBook can be downloaded in five minutes or less ......................................................................................................................... .............. Browse by Genre Available eBooks .............................................................................................................................. Art, Biography, Business, Chick Lit, Children's, Christian, Classics, Comics, Contemporary, Cookbooks, Manga, Memoir, Music, Mystery, Non Fiction, Paranormal, Philosophy, Poetry, Psychology, Religion, Romance, Science, Science Fiction, Self Help, Suspense, Spirituality, Sports, Thriller, Travel, Young Adult, Crime, Ebooks, Fantasy, Fiction, Graphic Novels, Historical Fiction, History, Horror, Humor And Comedy, ......................................................................................................................... ......................................................................................................................... .....BEST SELLER FOR EBOOK RECOMMEND............................................................. ......................................................................................................................... Blowout: Corrupted Democracy, Rogue State Russia, and the Richest, Most Destructive Industry on Earth,-- The Ride of a Lifetime: Lessons Learned from 15 Years as CEO of the Walt Disney Company,-- Call Sign Chaos: Learning to Lead,-- StrengthsFinder 2.0,-- Stillness Is the Key,-- She Said: Breaking the Sexual Harassment Story That Helped Ignite a Movement,-- Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones,-- Everything Is Figureoutable,-- What It Takes: Lessons in the Pursuit of Excellence,-- Rich Dad Poor Dad: What the Rich Teach Their Kids About Money That the Poor and Middle Class Do Not!,-- The Total Money Makeover: Classic Edition: A Proven Plan for Financial Fitness,-- Shut Up and Listen!: Hard Business Truths that Will Help You Succeed, ......................................................................................................................... .........................................................................................................................
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • DOWNLOAD THAT BOOKS INTO AVAILABLE FORMAT (2019 Update) ......................................................................................................................... ......................................................................................................................... Download Full PDF EBOOK here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download Full EPUB Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download Full doc Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download PDF EBOOK here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download EPUB Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... Download doc Ebook here { http://bit.ly/2m6jJ5M } ......................................................................................................................... ......................................................................................................................... ................................................................................................................................... eBook is an electronic version of a traditional print book that can be read by using a personal computer or by using an eBook reader. (An eBook reader can be a software application for use on a computer such as Microsoft's free Reader application, or a book-sized computer that is used solely as a reading device such as Nuvomedia's Rocket eBook.) Users can purchase an eBook on diskette or CD, but the most popular method of getting an eBook is to purchase a downloadable file of the eBook (or other reading material) from a Web site (such as Barnes and Noble) to be read from the user's computer or reading device. Generally, an eBook can be downloaded in five minutes or less ......................................................................................................................... .............. Browse by Genre Available eBooks .............................................................................................................................. Art, Biography, Business, Chick Lit, Children's, Christian, Classics, Comics, Contemporary, Cookbooks, Manga, Memoir, Music, Mystery, Non Fiction, Paranormal, Philosophy, Poetry, Psychology, Religion, Romance, Science, Science Fiction, Self Help, Suspense, Spirituality, Sports, Thriller, Travel, Young Adult, Crime, Ebooks, Fantasy, Fiction, Graphic Novels, Historical Fiction, History, Horror, Humor And Comedy, ......................................................................................................................... ......................................................................................................................... .....BEST SELLER FOR EBOOK RECOMMEND............................................................. ......................................................................................................................... Blowout: Corrupted Democracy, Rogue State Russia, and the Richest, Most Destructive Industry on Earth,-- The Ride of a Lifetime: Lessons Learned from 15 Years as CEO of the Walt Disney Company,-- Call Sign Chaos: Learning to Lead,-- StrengthsFinder 2.0,-- Stillness Is the Key,-- She Said: Breaking the Sexual Harassment Story That Helped Ignite a Movement,-- Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones,-- Everything Is Figureoutable,-- What It Takes: Lessons in the Pursuit of Excellence,-- Rich Dad Poor Dad: What the Rich Teach Their Kids About Money That the Poor and Middle Class Do Not!,-- The Total Money Makeover: Classic Edition: A Proven Plan for Financial Fitness,-- Shut Up and Listen!: Hard Business Truths that Will Help You Succeed, ......................................................................................................................... .........................................................................................................................
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici
  • Danke für das SlideShare und die wirklich interessanten Informationen.
       Répondre 
    Voulez-vous vraiment ?  Oui  Non
    Votre message apparaîtra ici

LeanIX Swagger REST API @ Open Source Konferenz FrosCon, Sankt Augustin

  1. 1. REST  APIs   dokumentieren  mit   Swagger Daniel  Pozzi,  FrOSCon 2015
  2. 2. Über  Swagger und  mich 2 https://github.com/bonndan https://swagger.io/ Apache  2  license
  3. 3. APIs  für  Nicht-­‐EntwicklerSwagger-­‐UI 3 Demo  (swagger-­‐demo   starten): http://localhost:8080/docs/index.html?url=http://localhost:8080 /api-­‐docs/swagger.json Offizieller  Swagger demo pet store: http://petstore.swagger.io/ In  Produktion: https://app.leanix.net/demo/api/v1/
  4. 4. 4
  5. 5. Das  Herzstück:  die   JSON  Spezifikation 5 Aus  dem  Demo: https://goo.gl/If4I2t
  6. 6. Swagger Workflow 6 JSON Spezifikation HTML  API  UI SDK  Generierung Code Annotation
  7. 7. Swagger Annotations 7 Swagger Annotations https://github.com/swagger-­‐api/swagger-­‐core/wiki/Annotations-­‐1.5.X Für  PHP:  http://zircote.com/swagger-­‐php/annotations.html
  8. 8. SDK  Generierung 8 Beispiel  für  PHP  und  Java: https://github.com/leanix/swagger-­‐demo-­‐codegen Konfiguration: https://goo.gl/plH6pB Ausführung   (leanix/swagger-­‐demo  erforderlich): $  ./generate-­‐php.sh $  ./generate-­‐php.sh
  9. 9. Swagger nutzt  Mustache 9 Code: https://goo.gl/cdlXKl
  10. 10. Java  und   Swagger Maven Swagger Plugin statt   Scala  Runtime! 10 https://github.com/leanix/swagger-­‐demo/blob/master/pom.xml#L77 Plugin: http://kongchen.github.io/swagger-­‐maven-­‐plugin
  11. 11. Tricks  und  Fallen 11 • Vorsicht  mit  Enums in  Swagger V1 • Map-­‐artige  Typen  erfordern  Handarbeit • Wie  man  Parameter  verbirgt  (Spec Filter):  https://goo.gl/21qtz9 • Java:  Swagger-­‐UI,  swagger.json in  Uberjar packen Bespiel  mit  Dropwizard:  https://goo.gl/jSP0GN • SwaggerUI kann  man  leicht  an  das  Unternehmens  – CI  anpassen,  im  demo-­‐Projekt  als  git submodule
  12. 12. Referenzen und  mehr 12 Mehr:   http://swagger.io/open-­‐source-­‐integrations/ Code: https://github.com/leanix/swagger-­‐demo Alternativen: https://raml.org https://github.com/mashery/iodocs http://www.mashery.com/api/io-­‐docs

×