前后端分离的接口规范是什么？

一、为何要分离

二、开发流程

2 基本格式 请求基本格式 GET请求、POST请求必须包含key为body的入参，所有请求数据包装为JSON格式，并存放到入参body中，示例如下： GET请求： xxx/login?body={“username”:“admin”,“password”:“123456”,“captcha”:“scfd”,“rememberMe”:1} POST请求： 响应基本格式 { 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内容 3 响应实体格式 { code: 200, data: { message: “success”, entity: { id: 1, 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 }] } } 禁止下拉框、复选框、单选框判定选中逻辑由前端来处理，统一由后端逻辑判定选中返回给前端展示； 5.6.2 Boolean类型 关于Boolean类型，JSON数据传输中一律使用1/0来标示，1为是/True，0为否/False； 5.6.3 日期类型 关于日期类型，JSON数据传输中一律使用字符串，具体日期格式因业务而定；