Building Great Web APIs

on YouTube ↗27m

" summary

Argues for an API‑first lifecycle: model with narrative API stories, diagram transitions, and describe with a tech‑agnostic profile (ALPS), then iterate via Apiary Blueprint sketches, OpenAPI prototypes and Node/Express builds using a DART (data/actions/resources/representations/transitions) mapping. Tests use simple curl sets and Postman/Newman for happy/sad paths; security uses OAuth/JWT (Auth0) and TLS; deploys via automated git push (Heroku example). Emphasizes idempotent PUTs, reversible releases, and “do no harm” versioning so updates and shutdowns don’t break clients.

AI-written summary · about

" chapters (8)

1. 0:00Intro
2. 2:00Welcome
3. 8:40Design Work
4. 13:00Prototyping
5. 16:00Data Models
6. 18:40Testing
7. 20:50Security
8. 22:20Release

" related talks

• 49mBuilding Software Better: API Lifecycle Management for DevelopersErik Wilde · GOTO Amsterdam 2024
• 35mBuilding Your API for LongevityMike Stowe · RubyConf 2014
• 27mUser focused API DesignRenato Oliveira · PyCon 2018
• 35mPrinciples of Awesome APIs and How to Build ThemKeavy McMinn · RubyConf 2019
• 21mIntroducing The API LifecycleAndreas Krohn · Nordic APIs World Tour 2015
• 59mHandy Tools for Designing Great Web APIsMike Amundsen · NDC Porto 2019
• 26mMastering API Strategies for Digital TransformationClaire Barrett · apidays London 2023
• 44mCrafting Great APIs with Domain-Driven DesignFabrizio Lazzaretti · Spring I/O 2026