REST,以及RESTful接口规范的讲解

REST 是面向资源的,这个概念非常重要,而资源是通过 URI 进行暴露。

REST API 是基于 HTTP的,所以你的API应该去使用 HTTP的一些标准。

REST是一个标准,一种规范,遵循REST风格可以使开发的接口通用,便于调用者理解接口的作用。

在设计web接口的时候,REST主要是用于定义接口名,接口名一般是用名次写,不用动词,那怎么表达“获取”或者“删除”或者“更新”这样的操作呢——用请求类型来区分。

比如,我们有一个friends接口,对于“朋友”我们有增删改查四种操作,怎么定义REST接口?

增加一个朋友,uri: generalcode.cn/v1/friends 接口类型:POST

删除一个朋友,uri: generalcode.cn/va/friends 接口类型:DELETE

修改一个朋友,uri: generalcode.cn/va/friends 接口类型:PUT

查找朋友,uri: generalcode.cn/va/friends 接口类型:GET

上面我们定义的四个接口就是符合REST协议的,请注意,这几个接口都没有动词,只有名词friends,都是通过Http请求的接口类型来判断是什么业务操作。

举个反例:generalcode.cn/va/deleteFriends 该接口用来表示删除朋友,这就是不符合REST协议的接口。

一般接口的返回值是JSON或者XML类型的,笔者在互联网的工作经验一般都是JSON类型的。

用HTTP Status Code传递Server的状态信息。比如最常用的 200 表示成功,500 表示Server内部错误,403表示Bad Request等。(反例:传统web开发返回的状态码一律都是200,其实不可取。)

那这种风格的接口有什么好处呢?前后端分离。前端拿到数据只负责展示和渲染,不对数据做任何处理。后端处理数据并以JSON格式传输出去,定义这样一套统一的接口,在web,ios,android三端都可以用相同的接口,是不是很爽?!

引用:https://blog.csdn.net/qq_21383435/article/details/80032375

引用详细:https://blog.csdn.net/intelrain/article/details/80449371

作者:RolexOO
链接:https://www.jianshu.com/p/b80eacc20fca
来源:简书
著作权归作者所有。非商业转载请注明出处。

(0)

相关推荐

  • Python之API:基于python语言调用华为云API(华为网站)实现特定功能

    Python之API:基于python语言调用华为云API(华为网站)实现特定功能 相关文章 Python之API:基于python语言调用华为云API(华为网站)实现特定功能 Python之API: ...

  • python大学专业

    本文仅练习爬虫程序的编写,并无保存任何数据,网址接口已经打码处理. 我们通过分析网络请求可以看到有这两个json文件: https://xxx.cn/www/2.0/schoolprovinceind ...

  • RESTful 架构以及 RESTful API开发

    时间主题11.06(周二)20:00 讲师养成之吸睛PPT的写成11.07(周三)20:00RESTful架构及RESTful API开发 在周三的测试运维试听课程中,芒果给大家介绍了RESTful架 ...

  • 今天,你抢到票了吗?

    今天网上开始预售除夕前一天的火车票. 这几天,办公室的小伙伴们每天准点蹲在电脑前,不停地刷新页面,可最终还是眼睁睁看着一秒之后就显示"无票"了.(╯‵□′)╯︵┻━┻ 无奈之下,只 ...

  • 02 restful接口规范

    restful接口规范 接口规范:就是为了采用不同的后台语言,也能使用同样的接口获取到同样的数据如何写接口:接口规范是 规范化书写接口的,写接口要写 url.响应数据 注:如果将请求参数也纳入考量范围 ...

  • 【Web API】通俗讲解 RESTful

    【Web API】通俗讲解 RESTful

  • 史上最简单通俗易懂的 RestFul 讲解!

    你知道的越多,不知道的就越多,业余的像一棵小草! 你来,我们一起精进!你不来,我和你的竞争对手一起精进! 编辑:业余草 juejin.cn/post/6896141260177244167 推荐:ht ...

  • S50学习资料讲解

    S50学习资料讲解

  • 黄煌经方言论精辟 伤寒总结性讲解

    一.黄煌经方言论精辟 1 舌苔不必过于在意.在杂病中,舌质比舌苔重要:体型体貌比脉象重要:精神状态比主诉重要. 2 本人研究经方 的着眼点,可能更重视整体,重视'人'的感受. 3 经方是中医学的一支流 ...

  • 电热水器电路图讲解

    描述 注水式电热水器电路 下面以海尔FCD-H65B型电热水器为例,介绍注水式电热水器电路的识图方法.该电路由的核心元器件是加热器.温控器.流量开关,如图4-30所示. 1.电源电路 220V市电电压 ...

  • 满满的干货!税务总局在线访谈讲解研发费用加计扣除新政策

    4月29日下午,国家税务总局举办"研发费用加计扣除新政策讲解"在线访谈活动.国家税务总局所得税司副司长刘宝柱就研发费用加计扣除最新政策以及企业10月份预缴享受上半年研发费用加计扣除 ...

  • 少林十三枪教学视频(德慈讲解、行侠示范)

    释德慈(1941-),俗名路振环.北京人.1989年在嵩山少林寺拜嵩山少林寺首座僧素喜大和尚为师,修禅习武.1991年在广东省大觉寺受三坛大戒,传戒师佛源大和尚,此后云游南粤.曾任北京少林拳研究会会长 ...

  • 两点做出好轮廓丨今晚八点半角色设计彭倩讲解“大剪裁与切割形状” ”

    图片素材来自网络,版权归原作者,仅供交流 ------------------- 有绘画学习的地方,就有原画人的身影 今天,我们分享一个由跟课天使秋月无言整理总结的 彭倩老师90分钟课程示范速涂笔记, ...