我们相信:世界是美好的,你是我也是。平行空间的世界里面,不同版本的生活也在继续...

restful接口是个规范,并非是某个代码某个模块,各种编程语言都可以实现restful接口。本文也就是描述一下restful接口的规范,做个相关内容的补充。实际上目前最新的接口规范,也不是restful,而是graphql

苏南大叔:如何理解restful接口?restful接口设计规范是怎样的? - restful接口规范
如何理解restful接口?restful接口设计规范是怎样的?(图1-1)

大家好,这里是苏南大叔的网络自留地,想写点啥就写点啥。本文写个restful接口规范,仅仅是阐述个定义,没有测试环境。

基本定义

Rest的全称是Representational State Transfer,2000年由Roy Fielding发表在他的博士论文中,首次提出了Restful的概念。Restful做为一种接口的设计规则,基于HTTP协议,可以使用XML格式或JSON格式传输数据。对于使用restful这套规则定义开发的接口,称之为Restful API

一句话概括:使用相同的URL定位资源,使用HTTP请求(GETPOSTPUTDELETE等)对资源进行操作。也就是说,不同的操作目的,最主要是使用请求的方法(method)来进行区分的。

传统的接口设计

在大家通常意义上的接口规范中,

  • 对资源的crud操作动词都体现在url接口地址上。
  • http的方法基本上只有getpost两种。
  • 一般使用session进行鉴权操作。
目的方法URL
新增文章post/article/create
获得文章get/article/read/id
修改文章post/article/modify
删除文章get/article/delete/id

restful接口规范

苏南大叔不想抄书,这里使用自己的理解来描述restful接口规范。

  • 对资源的crud操作动词都体现在接口请求的方式上,而地址上可能一致或近似。
  • http的方法基本上,除了getpost,还有put/patch/delete
  • 一般使用在头信息,使用token进行鉴权操作。
目的方法URL
新增文章post/article
获得文章get/article/id
修改文章patch/article/id
删除文章delete/article/id

相关文章

总结

restful就是个接口规范,遵守也行,不遵守也行。就像robots.txt一样,大家最好都遵守规则。但是你不遵守的话,也不会有啥问题。另外,写给自己的是:主要restful的签权方式,并不推荐使用传统的cookiesession,而是在头信息里面传递的token信息。

助理微信

微信打赏码

微信公众号

微信小程序

如果本文对您有帮助,或者节约了您的时间,欢迎打赏瓶饮料,建立下友谊关系。
本博客不欢迎:各种镜像采集行为。请尊重原创文章内容,转载请保留作者链接。

 【福利】 腾讯云最新爆款活动!1核2G云服务器首年50元!

 【源码】本文代码片段及相关软件,请点此获取更多信息

 【绝密】秘籍文章入口,仅传授于有缘之人   restful    api