需求
项目介绍¶
PetClinicRest 版本以 RESTful API 为主要交互方式,因此接口自动化测试的侧重点在于 验证接口的业务逻辑一致性、数据结构正确性与版本兼容性。测试需关注 请求参数校验、响应字段规范、状态码返回、业务流程完整性,特别是 宠物主人、宠物、兽医与就诊记录等实体之间的数据关联与变更结果。同时,应覆盖 正向与异常输入场景,验证系统在参数缺失、数据不存在或角色权限不足情况下的错误处理能力。对于接口版本迭代,应重点检查 新旧版本接口兼容、字段新增或变更导致的影响范围,确保更新不破坏现有业务。
需求¶
PetClinic_Rest 是一个宠物诊所管理系统的后端 RESTful API 接口,为前端提供了宠物、医生、预约等相关数据的增删改查功能。
2. 接口列表¶
2.1 宠物接口¶
2.1.1 获取宠物列表¶
- 请求路径:/pets
- 请求方法:GET
- 请求参数:无
- 返回结果:宠物列表的 JSON 数组
2.1.2 获取特定宠物信息¶
- 请求路径:/pets/{petId}
- 请求方法:GET
- 请求参数:petId,宠物的唯一标识
- 返回结果:特定宠物的 JSON 对象
2.1.3 创建宠物¶
- 请求路径:/pets
- 请求方法:POST
- 请求参数:新宠物的 JSON 对象
- 返回结果:新宠物的 JSON 对象
2.1.4 更新宠物信息¶
- 请求路径:/pets/{petId}
- 请求方法:PUT
- 请求参数:petId,宠物的唯一标识;更新后的宠物信息的 JSON 对象
- 返回结果:更新后的宠物的 JSON 对象
2.1.5 删除宠物¶
- 请求路径:/pets/{petId}
- 请求方法:DELETE
- 请求参数:petId,宠物的唯一标识
- 返回结果:删除操作的状态信息
2.2 医生接口¶
2.2.1 获取医生列表¶
- 请求路径:/doctors
- 请求方法:GET
- 请求参数:无
- 返回结果:医生列表的 JSON 数组
2.2.2 获取特定医生信息¶
- 请求路径:/doctors/{doctorId}
- 请求方法:GET
- 请求参数:doctorId,医生的唯一标识
- 返回结果:特定医生的 JSON 对象
2.2.3 创建医生¶
- 请求路径:/doctors
- 请求方法:POST
- 请求参数:新医生的 JSON 对象
- 返回结果:新医生的 JSON 对象
2.2.4 更新医生信息¶
- 请求路径:/doctors/{doctorId}
- 请求方法:PUT
- 请求参数:doctorId,医生的唯一标识;更新后的医生信息的 JSON 对象
- 返回结果:更新后的医生的 JSON 对象
2.2.5 删除医生¶
- 请求路径:/doctors/{doctorId}
- 请求方法:DELETE
- 请求参数:doctorId,医生的唯一标识
- 返回结果:删除操作的状态信息
2.3 预约接口¶
2.3.1 获取预约列表¶
- 请求路径:/appointments
- 请求方法:GET
- 请求参数:无
- 返回结果:预约列表的 JSON 数组
2.3.2 获取特定预约信息¶
- 请求路径:/appointments/{appointmentId}
- 请求方法:GET
- 请求参数:appointmentId