app和后端的交互,一般都是通过后端提供的api实现。api的设计,估计很多刚进入app后端的小伙伴会一无头绪,不知道怎么入门。下面根据自己8年的app后端经验,总结出下几个api设计原则,给小伙伴参考。
1. 什么是api?
这个问题在以前发表的文章“7.app和app后端的通讯”中其实已经回答了,这里再重复一次。
相信大家都用过银行的柜员机(ATM)的查询余额,转帐,取款等操作。
当在柜员机取款的时候,我们输入要取款的金额,隔一会钱就出来了,如果因为有什么问题不能取款(例如超过取款金额的限制),屏幕上也会显示出错误的信息。
在整个过程中,我们只要输入金额,获得结果(取款成功或不成功),就行了,至于柜员机内部是怎么处理,我们不需要理会。
柜员机这种把内部的处理遮蔽的做法极大方便了我们的使用。
同样的,在后端,也只提供了一系列的功能给app使用,这系列的功能以api的形式提供。
api的定义:API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。
当app调用api的时候,只需要明确下面3点:
1.这个api是干啥的(柜员机例子中,是取款功能,还是查询余额,还是转账)
2.知道要输入什么(柜员机例子中,取款要输入金钱)
3.知道结果是什么(柜员机例子中,取款是成功还是失败)
至于api内部是怎么处理的,app根本无需理会。
从这里可看出,api能在最大程度遮蔽了app后端复杂性,极大提高了app前端的开发效率。
2. api设计的8点
<

本文分享了关于APP社交类项目(类似微信)的后端API设计经验,包括API的基本概念、设计原则如Restful风格、命名规范、安全性、返回数据处理、图片处理策略、错误信息、在线测试文档和API版本升级的注意事项。旨在帮助开发者提高API设计效率和客户端的开发体验。
最低0.47元/天 解锁文章
2万+

被折叠的 条评论
为什么被折叠?



