Fake It Before You Make It: Mocking Your Way to Better HTTP APIs
summary
Proposes a design‑first workflow that uses OpenAPI/Swagger, RAML or API Blueprint plus JSON Schema to publish HTML docs, generate server stubs and run a live mock server so clients exercise expected requests and responses before implementation. Shows a runnable Flask implementation and a mock server that returns schema‑based sample payloads, updates on spec change, and a validation script (using ramification) that compares spec resources to implemented endpoints and flags missing routes.
AI-written summary · about
chapters (12)
- 0:00Introduction
- 0:49Terminology
- 3:15The Idea
- 5:19API Specification
- 6:56Swagger
- 9:08Rammell
- 11:24API Blueprint
- 12:45Differences
- 15:56Mocking
- 16:36Cogeneration
- 18:58Demo
- 30:44Python Support
related talks
43mImprove your API and OpenAPI
21mRevolutionizing API Design: The Power of Mock-Based Prototyping
27m"Building Elegant API Contracts: From Zero to Hero"
18mPrototype-first - a modern API development workflow
30mGenerating docs from APIs
25mThe Life Changing Magic of Becoming API First
21mDevelop in Parallel and Ship Earlier with OpenAPI and Mocking
35mAPI-First! Contract-First! Make API development great again!