Deck for presentation given for scala for startups meetup

1. Swagger for Startups
Tony Tam
@fehguy

2. Why Swagger?
The API
Development
Process is
Broken!

3. API Consumers get short end of stick
Build a technology
Slap on an API “Our API
Make clients suffer exposes
back end
resources”
“Server
doesn’t
care how
Client calls
it”

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. A Description-driven API Approach
• Describe the API
• How?
Javadoc WADL
s? WADL2
You need an ?
Develope API
r Docs? description
format!
WSDL?

6. Model, Iterate (then Code)
No code!
Just
JSON

7. The Benefit of a Description
API
Developer
OMG I can
code w/o
waiting for The client
back end! developer
isn’t bugging
me!
Client-Side
Developer

8. But…
SHOW
ME

9. Demo
• See demo here:
• http://github.com/fehguy/swagger-demo/README.md

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