API Design Lifecycle

on YouTube ↗15m

" summary

API design uses documentation-first iterations rather than waterfall: write an API Blueprint markdown contract, parse it into a JSON tree, generate mock servers so front-end developers build against real examples before the backend exists, and run automated checks against the implementation so the contract is enforced in continuous integration. The workflow produces executable prototypes, example requests/responses, and tests that catch mismatches early instead of months of rework.

AI-written summary · about

" chapters (5)

1. 0:00Start
2. 4:49Human
3. 5:14Different concerns
4. 6:02Different culture
5. 9:21Markdown file

" related talks

• 27mBuilding Great Web APIsMike Amundsen · apidays New York 2020
• 49mPoor API design is not sustainable.Markus Müller, Nico Balestra · apidays Dubai & Middle East 2022
• 21mIntroducing The API LifecycleAndreas Krohn · Nordic APIs World Tour 2015
• 49mBuilding Software Better: API Lifecycle Management for DevelopersErik Wilde · GOTO Amsterdam 2024
• 30mAPI Code First vs Design FirstPhil Sturgeon · apidays New York 2020
• 43mWhy You Should Be Doing Contract-First DevelopmentDeven Phillips · Jfokus 2023
• 25mThe Life Changing Magic of Becoming API FirstJoyce Lin · Infobip Shift 2021
• 59mHandy Tools for Designing Great Web APIsMike Amundsen · NDC Porto 2019