职责分离 开发流程 - 后端编写和维护接口文档,在 API 变化时更新接口文档
开发完成后联调和提交测试
Mock 服务器根据接口文档自动生成 Mock 数据,实现了接口文档即API: 关于Mock数据有哪些好的平台和工具,这在前文《前后端都分离了,该搞个好用的API管理系统了!》中也介绍过了,嘻嘻,需要可以去翻翻看。
规范原则 基本格式示例 下文开始给出一个前后端交互数据的基本示例,具体大家可以根据自己的业务或者编码习惯做些许调整,切勿拘泥于文中示例!
所有请求数据包装为JSON格式,示例如下: xxx/login?body={'username':'admin','password':'123456','captcha':'scfd','rememberMe':1}
{
code: 200,
data: {
message: 'success'
}
}
code :表示请求处理状态,示例值如下
200: 请求处理成功500: 请求处理失败401: 请求未认证,跳转登录页406: 请求未授权,跳转未授权提示页
data.message : 表示请求处理消息
code=200 且 data.message='success': 请求处理成功code=200 且 data.message!='success': 请求处理成功, 普通消息提示:message的内容code=500: 请求处理失败,警告消息提示:message的内容
{
code: 200,
data: {
message: 'success',
entity: {
id: 1,
name: 'XXX',
code: 'XXX'
}
}
}
data.entity : 响应返回的实体数据
{
code: 200,
data: {
message: 'success',
list: [
{
id: 1,
name: 'XXX',
code: 'XXX'
},
{
id: 2,
name: 'XXX',
code: 'XXX'
}
]
}
}
data.list : 响应返回的列表数据
{
code: 200,
data: {
recordCount: 2,
message: 'success',
totalCount: 2,
pageNo: 1,
pageSize: 10,
list: [
{
id: 1,
name: 'XXX',
code: 'H001'
},
{
id: 2,
name: 'XXX',
code: 'H001'
} ],
totalPage: 1
}
}
data.recordCount : 当前页记录数 data.totalCount : 总记录数 data.pageNo : 当前页码 data.pageSize : 每页大小 data.totalPage : 总页数
下拉框、复选框、单选框 由后端接口统一逻辑判定是否选中,通过isSelect标示是否选中,示例如下: {
code: 200,
data: {
message: 'success',
list: [{
id: 1,
name: 'XXX',
code: 'XXX',
isSelect: 1
}, {
id: 1,
name: 'XXX',
code: 'XXX',
isSelect: 0
}]
}
}
禁止下拉框、复选框、单选框判定选中逻辑由前端来处理,统一由后端逻辑判定选中返回给前端展示;
关于Boolean类型,JSON数据传输中一律使用1/0来标示,1为是/True,0为否/False; 关于日期类型,JSON数据传输中一律使用字符串,具体日期格式因业务而定;
若有错误或者不当之处,可在本公众号内反馈,一起学习交流!
|