Talk Python To Me #450: Versioning Web APIs in Python
69 snips
Feb 22, 2024 Exploring the challenges of upgrading APIs, the importance of versioning for smooth transitions, insights on API design principles, handling system behaviors with Neo4j, strategies for versioning web APIs in Python, and recommendations for choosing the right versioning approach.
AI Snips
Chapters
Transcript
Episode notes
Design Teams To Shape APIs
- Conway's law links team structure to product interfaces, so design teams to match desired APIs.
- Reverse Conway maneuver intentionally shapes organization to deliver intended API boundaries.
MailChimp API Break Caused Eight-Hour Fix
- Michael recounts breaking MailChimp changes that forced him to rewrite integrations for hours.
- He describes how sudden API shutdowns left user-facing features broken and required eight hours to fix.
Versioning Tradeoffs From Duplication To Translation
- There are multiple versioning strategies ranging from full app duplication to per-endpoint copies and schema translation.
- Each step down in duplication reduces operational cost but increases runtime translation complexity.