移动端接口设计思想
来源:互联网 发布:三星4300清零软件 编辑:程序博客网 时间:2024/05/22 07:48
情景描述:本人是java后端开发,配合Android移动端开发 1.支付接口; 2.订单支付状态查询接口。
问题:接口响应报文结构,自己设计出来后,总是和移动端需要的有很大的出入。
解决:
接口1:支付接口
支付只是一次请求,不包含任何业务参数。
移动端需要信息:请求是否成功;如果失败,失败原因是什么。
响应报文核心字段:
retcode:SUCCESS/FAIL
retmsg: 支付成功/缺乏必须参数等。
可能的响应报文:
1.支付成功
retcode:SUCCESS
retmsg: 支付成功
2.通信失败
retcode:FAIL
retmsg: 网络断开
3.通信成功,交易失败
retcode:FAIL
retmsg: 账户余额不足
说明:此处的失败是通信失败(网络断开) 和 请求失败(余额不足)的并集,但是并不需要区分开,因为移动端不需要区分,他只关注支付成功或失败。
接口2:支付状态查询接口
支付状态查询:不仅是一次请求,同时需要包含业务参数:支付状态。
移动端需要信息:请求是否成功;如果成功了,业务参数:支付状态具体值。
响应报文核心字段:
retcode:SUCCESS/FAIL
retmsg: 查询成功/查询失败等。
payState: 0:支付成功 1支付失败
可能的响应报文:
1.通信成功且支付成功
retcode:SUCCESS
retmsg: 查询成功
payState:0
2.通信成功但支付失败
retcode:SUCCESS
retmsg: 查询成功
payState:1
3.通信失败
retcode:FAIL
retmsg: 网络断开
说明:此处的失败只是代表通信失败(网络断开) ,只有通信成功了,再去查看 请求成功与否,从而获取需要的业务参数:比如此处的支付状态。
事后反思:
1.换位思考:明确这两个接口是提供给移动端使用:如何设计才能让移动端高效、快捷地拿到他想要的信息。不要用自己java后端开发的思维定势去设计。
2.与他人合作开发,观照情绪,别被情绪拖着走:渐渐发现,IT工作碰到的很多问题,不良的情绪总是可以导致工作效率低下,本来会做的事情,却做的很吃力。
比如:这次合作开发,移动端开发者:嗓门很大,气势咄咄逼人。虽然理智知道他的修改建议很正确,可是自己心里有个魔鬼跳出来:他谁啊!为啥要听他的!导致自己很大的精力,被嗔怒的情绪所消耗。或者,开发中碰到一个完全没有接触过的东西,本人有时候会对自己不能掌控的东西,有种莫名的恐惧。这个恐惧的情绪,导致你不敢大步向前走,奋起直前解决问题。(果真生活中处处是修行啊!)
生活所感,仅此小记
- 移动端接口设计思想
- 移动端接口开发经验一二
- 20161115做移动端接口总结
- 房贷计算器移动端接口
- 使用Thinkphp框架开发移动端接口(1)
- 使用Thinkphp框架开发移动端接口(2)
- SpringMVC开发移动端接口(返回Json数据)
- springMVC框架下如何实现移动端接口调用
- springMVC框架下如何实现移动端接口调用2
- springmvc 移动端接收图片
- 移动端接口编程之服务器配置与简单API接口实例
- 如何写好接口(php写app移动端接口示例)
- springMVC框架下如何实现移动端接口调用——流程简介篇
- springMVC框架下如何实现移动端接口调用——代码实例
- BCM5482s 端接电阻PCB布局设计
- JAVA 调用SAP端接口
- JAVA 调用SAP端接口
- JAVA 调用SAP端接口
- 31.读书笔记收获不止Oracle之表的合并排序连接
- SpringMVC基础-6-异常处理器
- 打响联通混改第一枪,京东推动第四次零售革命深化
- 32.读书笔记收获不止Oracle之表链接的驱动顺序
- Android 把.java转成.dex
- 移动端接口设计思想
- 33.读书笔记收获不止Oracle之表连接的排序分析
- ng2基本命令
- 彻底学会VMware虚拟机:[9]如何连接网络
- 34.读书笔记收获不止Oracle之表连接场景对比
- 浅析Springmvc
- http://blog.jobbole.com/70549/
- AS打包apk及常见错误解决办法Error:(4) Error: "ssdk_instapager_login_html" is not translated in "en" (English)
- 浅谈GET和POST区别