『政善治』Postman工具 — 3、补充：restful风格接口的项目说明

（一）RESTful架构风格特点
（二）JSON数据格式说明

（一）RESTful架构风格特点

1、统一接口风格

http://服务器地址:端口号[/项目名称/版本/资源]

http://：为我们HTTP协议的访问头标准。
服务器地址：为我们项目服务器IP地址。
端口号：为我们服务器内项目访问的指定编号。
[/项目名称/版本] ：可选。
资源：互联网-图片、音乐、视频、文本、数据。

2、规范的HTTP请求方法

GET：从服务器取出资源（一项或多项）。
POST：在服务器新建一个资源。(单条或多条)
PUT：在服务器更新资源。
DELETE：从服务器删除资源。

3、HTTP响应码

序号	状态码	动词	说明
1	200	GET	服务器成功返回用户请求的数据
2	201	POST	用户新增数据成功
3	201	PUT	用户修改数据成功
4	204	DELETE	用户删除数据
5	400	POST/PUT	用户发出的请求有错误，服务器没有进行新建或修改数据的操作
6	404	GET	服务器没有返回资源.

4、什么是无状态

为什么说HTTP协议是无状态的协议呢？

因为它的每个请求都是完全独立的，每个请求包含了处理这个请求所需的完整的数据，发送请求不涉及到状态变更。

而且再次请求也无法判断他是否之前请求过，如果后续处理需要前面的信息，则它必须重传，这样可能导致每次连接传送的数据量增大。

看看下面故事你会有所启发。

无状态（Stateless）

魔都的老王开了一个会所，一个开会的地方，有大会议室、小会议室、Cosplay情景会议室。

顾客听说这个会所有特色，于是纷纷前来消费，小明就是其中的一员。

小明上次会议室体验很棒，尽管有点贵，本周又前来消费。

结账时，小明以为老王认识自己，和老王套近乎弄个优惠价："王老板，我上周刚来过，打个折扣呗"！

老王很茫然地瞅着小明："上周你来过？我好像一点印象也没有了嘛，很抱歉，无法优惠"！

小明很不爽地付完钱走人...
有状态（Stateful）

老王有一个助手叫小王，看到这一幕于是和老板有一番对话：

小王：老板，下次客人来消费，咱们给客人发一张小卡片，来一次打卡一次，凡是打过卡的，都有优惠。来的

次数越多，折扣力度越大，这样就能有更多的回头客，您看如何？

老王连说这是好主意，以后就这么干！

小明第一次来领了一张考勤卡，打了卡，夹在钱包里。

第二次来消费埋单时，小明从自己的钱包掏出考勤卡，老王一看原来是回头客，好说好说，88折优惠，小明和老王都笑的合不拢嘴...
Cookie

后来老王觉得考勤卡上，还应该多记录一些内容，才能更好地服务客户，考勤卡上慢慢增加了更多内容。

会员卡片样例如下：

小明再次来消费时，不仅可以优惠，还可以根据小明的消费习惯，做出最合理的安排。

随着服务的精细化，小卡片上描述客户的信息越来越多，卡片越做越大，由于小卡片受4K字节的限制，每次客户前来消费都要携带大大的卡片，这很夸张！
Session

小王寻思着，小卡片一直都是客户携带，为何不在公司的电脑上弄个数据库，记录客户的消费习惯，每个客户有一个数据库明细。

客户明细如下：

给小明的小卡片上只要有一个客户代号"08029snne3e0kekllojeis007"就可以了，查询电脑就可以知道是小明消费信息和消费习惯，消费完还可以从账户余额内扣除。

这个客户代号就是SessionlD，通常保存在客户端浏览器的Cookie里。

总结：

上文故事中的"Stateless"、"Stateful"、"Cookie"、"SessionID"以及"Session"与HTTP协议中这些关键词具有相类似的意思。

HTTP最初的设计是无状态的（stateless），但是无状态的HTTP无法满足互联网日益发展的需求，于是业界扩展了HTTP协议，增加了有状态（stateful）协议头，使之变成一个有状态协议。

这个有状态的协议头，就是依靠Cookie来实现的，Cookie是维系客户端与服务器之间状态同步的纽带。

无论什么类型的Cookie，都是由服务器来一手创建，最终解释权归服务器，只有服务器才理解这些Cookie所代表的真正涵义；客户只负责携带，不需要理解Cookie的真正意义！

（二）JSON数据格式说明

restful风格接口的数据返回格式一般为：JSON数据格式。

1、什么是JSON

JSON 指的是 JavaScript 对象表示法（Java Script Object Notation）。

JSON 是轻量级的文本数据交换格式。

JSON 具有自我描述性，更易理解。

2、JSON格式的特点

JSON 是纯文本，具有"自我描述性"和“层级结构性”。

读写的速度更快，消耗流量少。

3、JSON语法

格式1

JSON对象: {"键1":"值1","键2":"值2"}
格式2

JSON数组: [值1,值2,值3.....]
格式3

对象+数组：{"name":"葫芦娃","age":"8","技能":[" "," "," "]}
格式4

数组+对象：[{"name":"葫芦娃","age":"8"},{"name":"葫芦娃","age":"8"}]

参考：https://www.zhihu.com/question/23202402，解释的很精彩。