proposal.detail
提议
API Contract Court: Break, Version, and Fix a Public API
一场角色扮演式的工程试验,旨在让客户团队阐明破坏性变更带来的负面影响。
混合 · 2 小时 · 2026年七月21 · 2026年六月3
描述
section.description一个团队负责 API,另一个团队负责客户端集成,而评判标准则是一套会失败的测试用例。参与者会引入版本控制错误、歧义字段、未记录的默认值以及破坏性的响应变更,随后通过协商达成更安全的契约。
本实验涵盖了 OpenAPI 风格的思维方式、兼容性测试、弃用通知、错误形态设计以及迁移窗口。之所以令人印象深刻,是因为每一个糟糕的 API 决策都会立即给房间里的另一个团队带来困扰。