Where's Waldo: Building Better APIs with Swagger

Transcript

1. Where’s Waldo?: Building Better APIs with Swagger Natasha Carlyon natasha.carlyon@greatersum.com @nscarlyon
2. Natasha Carlyon • Software Crafter • https://www.greatersum.com/ • @nscarlyon • http://speakerdeck.com/ • natasha.carlyon@greatersum.com
3. Jeff Bezos Mandate
4. Jeff Bezos Mandate 6. Anyone who doesn't do this will be fired.
5. Swagger
6. API Maturity Model • Level 0 • Level 1 • Level 2 • Level 3 https://martinfowler.com/articles/richardsonMaturityModel.html
7. Hypertext • Roy Fielding • Discoverability • Flexibility
8. Status Codes • 200 (OK) • 201 (Created) • 202 (Accepted) • 204 (No Content) • 301 (Moved Permanently) • 303 (See Other) • 304 (Not Modified) • 400 (Bad Request) • 401 (Unauthorized) • 404 (Not Found) • 405 (Method Not Allowed) • 406 (Not Acceptable) • 409 (Conflict) • 500 (Server Error)
9. Resources • https://github.com/domaindrivendev/Swashb uckle.AspNetCore • https://github.com/Microsoft/aspnet-api-vers ioning
10. Natasha Carlyon • Software Crafter • https://www.greatersum.com/ • @nscarlyon • http://speakerdeck.com/ • natasha.carlyon@greatersum.com