Contract-First API Dev Using OpenAPI Spec / Swagger [2/2] - Dave Forgac & Ian Zelikman - OSCON 2017

Tutorial part 2/2
Part 1:    • Contract-First API Dev Using OpenAPI ...  
Installation instructions & resources: http://betterapis.com/

Some developers implement APIs, thinking about things like specifications and documentation only after they’re released. Dave Forgac and Ian Zelikman demonstrate how to use a contract-first approach to API development using the OpenAPI Specification (formerly called Swagger) and other open source tools. Dave and Ian walk you through defining a simple API specification, using it to generate documentation, a mock server, and stub code, and implementing a working API based on the specification.

Topics include:

The contract-first approach
Building and validating a simple OpenAPI Specification
Generating reference documentation and incorporating it with other docs
Running a mock server so clients can test using the API
Generating stub code based on the specification
Implementing a basic working API
Iteratively adding features and making changes
Generating specifications for existing APIs