规范负责人：所有人
一、目的：为了规范swagger接口的描述、加强接口质量控制、接口跟踪、减少品控人员与研发人员对接口理解的分歧，从2019-4-1日开始执行如下规范。
二、规范要求：
swagger文档必须符合如下要求：
1、提测申请单中提交测试的接口必须在swagger中有对应的接口文档描述；
2、swagger上接口名称，状态码与实际接口调用作用/返回码保持一致；
3、swagger文档必须能正常调用对应环境的接口，在swagger上可以直接进行对应项目、对应服务接口的调用；
4、接口文档各个字段的类型、长度边界、特殊校验等必须进行说明；
5、接口测试过程中发现的以上问题及时进行记录、跟踪、推进和解决，接口测试通过的条件为swagger文档符合要求、接口无明显Bug，否则不允许上线；
6、符合总集对swagger、接口相应规范的要求，与品质管控部冲突的以总集为准。
三、管理办法
1、此规范于2019-4-1日开始执行生效，由各个城市通测试负责人与研发同步、推进和跟进。
2、过渡期完成后，如未按照规范制定实施的，测试人员对该提测内容拒绝测试，并对该过程记录到过程问题中。
3、该问题过程记录在项目结束后统计部门触发次数，并对此实施处罚。
网友评论