Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Swagger for startups

2,075 views

Published on

Deck for presentation given for scala for startups meetup

Published in: Technology

Swagger for startups

  1. 1. Swagger for Startups Tony Tam @fehguy
  2. 2. Why Swagger? The APIDevelopment Process is Broken!
  3. 3. API Consumers get short end of stickBuild a technologySlap on an API “Our APIMake clients suffer exposes back end resources” “Server doesn’t care how Client calls it”
  4. 4. Then what’s right?• Describe the API interface! • Methods • You Params, allowable values, ranges have • Models to commit• Set expectations! to your service!• Build from the interface
  5. 5. A Description-driven API Approach• Describe the API • How? Javadoc WADL s? WADL2 You need an ? Develope API r Docs? description format! WSDL?
  6. 6. Model, Iterate (then Code) No code! Just JSON
  7. 7. The Benefit of a Description API DeveloperOMG I can code w/owaiting for The clientback end! developer isn’t bugging me!Client-SideDeveloper
  8. 8. But…SHOW ME
  9. 9. Demo• See demo here: • http://github.com/fehguy/swagger-demo/README.md
  10. 10. More Info• Wordnik Developer: • http://developer.wordnik.com • http://tech.wordnik.com• Swagger: • http://swagger.wordnik.com Questions? • http://github.com/wordnik/swagger-codegen• Scalatra: • http://scalatra.org• All of the above: • http://www.wordnik.com/jobs

×