系统开发实践 前后端交互规范
346 字
2 分钟
系统开发实践 前后端交互规范
经过团队内部讨论并达成一致, 前后端系统交互时, 我们遵循以下规范
后台响应报文规范
{ "code": 200, // 200-正常返回, 401-未登录, 403-权限不足, 500-业务异常(或者服务器异常) "data": {}, // 响应的数据 "errorCode": "", // 如果失败时, 会有对应的异常代码 "message": "" // 用于辅助信息提示}前端请求规范
前端在向后端发送数据请求时, 必须在 header 中带入识别用户身份信息的 token, 请求报文上支持表单格式和 json 格式, http 请求方法上, 原则上查询请求使用 GET, 提交修改数据统一使用 POST
请求 header 头设计说明
| 字段名 | 说明 |
|---|---|
| token | 用户会话标识 |
| user-id | 用户id, 用于 nginx 日志采集 |
| ga-xxx | 一些特定的信息收集字段, 例如经纬度, 手机型号等等 |
| timestamp | 请求时间搓 |
| app-version | app版本号 |
分页数据请求规范
{ "pageNum": 1, // 分页页码 "pageSize": 200, // 分页大小 "condition1": "aaa", // 搜索条件1 "condition2": "bbb", // 搜索条件2 "condition3": "ccc", // 搜索条件3 "sort": { "field": "", // 排序字段 "order": "asc" // 升序降序 }}分页数据响应规范
{ "code": 200, "data": { "pageNum": 1, // 分页页码 "pageSize": 200, // 分页大小 "total": 1000, // 数据总量 "content": [{},{}] // 分页数据}文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!
相关文章智能推荐
1
系统开发实践 Spring Cloud 异常封装及传递处理
技术分享准备将 RPC 协议从 dubbo 切换为 feign, 记录一些系统设计细节
服务端的异常输出设计
OpenFeign 的异常传递捕捉处理
2
通过 GitHub Actions 实现跨仓库 Blog 自动部署
技术分享介绍如何在源仓库的博客目录发生变更后,通过 GitHub Actions 自动触发另一个仓库的静态网站部署流程。
3
ETF 是什么
金融常识用购物篮类比解释 ETF 的定义、常见类型、优点与风险,以及它和股票、普通开放式基金的区别。
4
在 PVE 上给软路由虚拟机加一个网络 Watchdog
技术分享在 PVE 宿主机上用 Bash 和 systemd timer 实现一个网络 watchdog:先检测公网连通性,连续失败后重启软路由虚拟机,多次自愈无效再升级为重启 PVE 宿主机。
5
命令行自动登录 JumpServer:SSH、TOTP 与密码提示的自动化
技术分享把 JumpServer 登录流程拆成凭据读取和终端交互两层:zsh 从密码管理器安全读取 TOTP seed 与可选密码,expect 只负责响应 SSH 登录过程中的 password 和 Code 提示。
随机文章随机推荐












