好的参考，值得反复打开。

先对齐接口约定：OpenAPI 规范阅读入口

接口名称相同，并不意味着请求、响应和错误条件已经对齐。OpenAPI 官方规范为这些约定提供结构化描述方式，适合团队以一个小接口为起点，梳理输入输出与安全要求。