Introduction to API Drift

on YouTube ↗44m

" summary

API drift means implementation diverges from documentation — proof: a websocket-based collaborative drawing app wired to FastAPI shows connections jump from 1 to 2 and real-time drawing works only when contract matches implementation. The demo uses an AsyncAPI parser validation that rejects messages with unexpected fields (no additionalProperties), showing how design-first spec-driven codegen plus GitHub Actions, schema registries and generated docs prevent broken integrations and reduce support cost.

AI-written summary · about

" chapters (11)

1. 0:00Introduction
2. 1:47What is API drift
3. 5:01API drift causes
4. 7:30Impact of API drift
5. 10:21AsyncAPI for event-driven APIs
6. 14:21Design-first approach
7. 20:47Demo: AsyncAPI app
8. 31:59Enforcing contracts with Passer
9. 38:40Event drift prevention
10. 40:08Best practices
11. 43:21Key takeaways and closing remarks

" related talks

• 25mTackling OpenAPI DriftIkenna Nwaiwu · apidays Paris 2024
• 49mPoor API design is not sustainable.Markus Müller, Nico Balestra · apidays Dubai & Middle East 2022
• 47mDesign First: OpenApi and AsyncApi in Action!Philippe Bousquet · DevFest Nantes 2025
• 21mIntroducing The API LifecycleAndreas Krohn · Nordic APIs World Tour 2015
• 27mBuilding Great Web APIsMike Amundsen · apidays New York 2020
• 15mAPI Design LifecycleHonza Javorek · Platform Summit 2014
• 47mContract-Driven API Development with OpenAPI SpecificationDmitry Pashkevich · Developers Summit 2021
• 31mAsyncAPI is here to stayRolando Carrasco, Leonardo Gonzalez · AsyncAPI Conference 2021