文章目录
#1.restful api是什么?
答:restful api 是一种网络api架构,是一种规范。我们可以理解为设计项目时的文件分类。有规范,逻辑清晰。使我们能更好的去开发。
restful api是基于http的一种接口规范,是一种无状态的(http1.1版本之前)。
#2.为什么使用restful api标准(相比其他标准)
答:HTTP协议-URL#
HTTP是一个属于应用层的协议,特点是简捷、快速。
#2.1相比其他标准
效率和易用性#
SOAP由于各种需求不断扩充本身协议的内容,导致在SOAP处理方面的性能有所下降。同时在易用性方面以及学习成本上也有所增加。
RESTful由于其面向资源接口设计以及操作抽象简化了开发者的不良设计,同时也最大限度的利用了Http最初的应用协议设计理念。
安全性#
RESTful对于资源型服务接口来说很合适,同时特别适合对于效
率要求很高,但是对于安全要求不高的场景。
SOAP的成熟性可以给需要提供给多开发语言的, 对于安全性
要求较高的接口设计带来便利。所以觉得纯粹说什么设计模
式将会占据主导地位没有什么意义,关键还是看应用场景。
restful适合做什么开发
接口或者应用
#3.采用restful api 设计一般使用什么样的规范?(参考阮一峰老师的文章)
#3.1协议
API与用户的通信协议,总是使用HTTPs协议。(http也可以,但是建议使用https)
#3.2域名
应该尽量将API部署在专用域名之下。
例如:https://api.example.com
如果确定API很简单,不会有进一步扩展,可以考虑放在主域名下。
例如:https://example.org/api/
#3.3版本(Versioning)
应该将API的版本号放入URL。
例如:https://api.example.com/v1/
另一种做法是,将版本号放在HTTP头信息中,但不如放入URL方便和直观。Github采用这种做法。
#3.4路径(Endpoint)
路径又称"终点