RESTful API 接口测试用例 - /api/test (POST)

RESTful API 接口测试用例 - /api/test (POST)

该文档包含 /api/test 接口的测试用例，涵盖了正常请求、参数错误、字段类型错误、字段长度错误等多种情况。

接口信息

• 接口类型：RESTful 风格
• 请求方法：POST
• 请求地址：/api/test
• 请求头：
  • name：姓名
  • sex：性别
  • age：年龄
  • class：班级
• 请求体：
  • score：分数

测试用例

1. 正常情况下，请求参数正确，返回成功信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class=2A
  • body: {'score': 90}
• 预期输出结果：
  • 返回码：200
  • 返回信息：{'msg': 'success'}

2. 请求参数中缺少必填字段，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class=2A
  • body: {'score': null}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': 'score字段不能为空'}

3. 请求参数中某个字段类型不正确，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class=2A
  • body: {'score': 'abc'}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': 'score字段类型不正确'}

4. 请求参数中某个字段超过最大值，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class=2A
  • body: {'score': 101}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': 'score字段不能超过100'}

5. 请求参数中某个字段不存在，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class=2A
  • body: {'grade': 3}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': '请求参数错误，不存在grade字段'}

6. 请求参数中header中缺少必填字段，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25
  • body: {'score': 90}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': '缺少必填的header字段class'}

7. 请求参数中header中某个字段类型不正确，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class='2A'
  • body: {'score': 90}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': 'header中class字段类型不正确'}

8. 请求参数中header中某个字段超过最大值，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, class=3B
  • body: {'score': 90}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': 'header中class字段不能超过2A'}

9. 请求参数中header中某个字段不存在，返回错误信息

• 输入参数：
  • 请求方式：POST
  • 请求地址：/api/test
  • header：name=Tom, sex=Male, age=25, grade=3
  • body: {'score': 90}
• 预期输出结果：
  • 返回码：400
  • 返回信息：{'msg': '请求参数错误，不存在grade字段'}