小天今天给分享restful接口的知识,其中也会对restful接口开发进行解释,希望能解决你的问题,请看下面的文章阅读吧!
restful接口(restful接口开发)
restful接口(restful接口开发)
restful接口(restful接口开发)
1、restful api接口规范如下:1、协议API与用户的通信协议,总是使用HTTPs协议。
2、2、域名应该尽量将API部署在专用域名之下。
3、如果确定API很简单,不会有进一步扩展,可以考虑放在主域名下。
4、3、版本(Versioning)应该将API的版本号放入URL。
5、另一种做法是,将版本号放在HTTP头信息中,但不如放入URL方便和直观。
6、Github采用这种做法。
7、4、路径(Endpoint)路径又称"终点"(endpoint),表示API的具体网址。
8、在RESTful架构中,每个网址代表一种资源(resource),所以网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。
9、一般来说,数据库中的表都是同种记录的""(collection),所以API中的名词也应该使用复数。
10、举例来说,有一个API提供动物园(zoo)的信息,还包括各种动物和雇员的信息,则它的路径应该设计成下面这样。
本文到这结束,希望上面文章对大家有所帮助。