402 B
402 B
🔗 接口分域与维护原则
这部分不替代 Swagger，而是定义接口文档应该怎样围绕业务域维护。
1. 推荐按域维护
- system
- infra
- iot
- ops
2. 为什么不按页面维护
因为页面会变，但领域边界更稳定。
同一个接口可能同时服务：
- 后台页面
- 移动端页面
- 规则联动
所以接口文档优先按域维护更稳。
这部分不替代 Swagger，而是定义接口文档应该怎样围绕业务域维护。
因为页面会变，但领域边界更稳定。
同一个接口可能同时服务：
所以接口文档优先按域维护更稳。