- url 命名，主要基于《规范》，主要排查：
- 是否表意正确；
- 力求表意一眼就能看懂，不关心具体实现逻辑
- Path 传参数：资源/资源ID，比如苹果/苹果ID, 梨子/梨子ID，必须严格遵循。
- 命名要采用通用标准，比如 url 中的 check 要加就统一加，不加就统一不加。
- 是否有冗余
- 大小写、单复数
- description 是否足够表意或有冗余
- 是否表意正确；
- put/get/post
- 是否用对相应的操作方式
- 对应输入输出采用的数据格式等是否符合《规范》要求
- parameters in
- 内容是否缺失或多余
- path/query/body 是否选对
- type
- description
- 大小写、单复数
- response
- 内容是否缺失或多余
- path/query/body 是否选对
- type
- description
- 大小写、单复数
- 检查返回值形式是否与数据库形式相同，要表意明确
网友评论