一、首次下载和使用
访问上面的链接后再点击下载:
下载之后,点击不创建用户也可使用,当然你也可以注册:
二、网站相关参数
1.出参和入参
【预览】和响应一样都是后端返回的,只不过预览效果好看点
三、使用postman测试接口
1.请求URL的组成介绍
打开网站可以复制请求URL,它的组成如下:
红色是服务器地址,橙色是接口路由,绿色是请求参数
http://localhost:12924/api/Customer?Name=123
2.在Postman中使用请求URL
【注意事项】
关于授权
【请求参数中添加token】
1.所有请求基本都需要传入token
【什么是token】
1.标记用户身份的一个ID,进行资源关联
2.不同ip(或者说不同开发环境)不同token
3.token可以保持登录状态,不需要反复输账密,但是token会失效,失效后需要重新登录
【请求头中添加token】选择对应类型的令牌,输入令牌即可在授权的情况下发送PUT/POST/UPDATE等敏感操作的请求
关于请求的入参规范
2.Get请求入参的数据如下所示,其中列表的数据要用中括号包裹
3.Post/Put/Delete请求的入参数据如下所示:用JSON输入
【JSON的输入格式获取方式】
【简单版-短JSON】
【长JSON】
【普通字段传参示例】
{
"Data":
{
"CustomerID": "2909f242-0ff6-4c2d-a2ae-aa2c9aa09161",
"CustomerName": "xiaoxiao",
"IsEnabled": 1,
"CustomerMobile": null,
"PersonLiableName": "业务员"
}
}
【泛型列表传参示例】
{
"Data":
{
"confingListModel":
[
{
"ConfigID": "3aaddc92-f8ee-48ce-89c4-65be3ad15be4",
"ConfigValue": "100"
},
{
"ConfigID": "0b6aae8c-94b4-46a3-9c35-1b677bbee5df",
"ConfigValue": "220"
}
],
"cYear": 2022
}
}
关于400错误
400报错:The request cannot be fulfilled due to bad syntax.
- 1.检查Headers是否勾选或者勾选正确(Host必须勾选,POST请求时Content-Type必须勾选、Authorization视情况填写)
- 2.检查Body中Raw的json格式是否正确
关于本地和服务器接口不一致
1.原因:账号问题(数据不同);发布错了服务器地址;本地没有【完全】提交文件;
2.排查方法:同一账号下验证;查日志表看报错信息;
遇到Bug的测试顺序是什么?
1.本地+新数据
2.本地+同测试数据3.测试+新数据
4.测试+同测试数据