REST与RESTFul API最佳实践
来源：http://www.imooc.com/article/17650
REST：REpresentational State Transfer，中译为“表属性状态传递”。这是什么鬼？这并不重要，本来就个名字就源自于国外的一个博士的一篇论文。我们主要要知道基于这篇论文里的理论，衍生出了RESTFul API的接口设计风格。
我们一起来看看RESTFul API有哪些特点：
- 基于“资源”，数据也好、服务也好，在RESTFul设计里一切都是资源。
- 无状态。一次调用一般就会返回结果，不存在类似于“打开连接-访问数据-关闭连接”这种依赖于上一次调用的情况。
- URL中通常不出现动词，只有名词
- URL语义清晰、明确
- 使用HTTP的GET、POST、DELETE、PUT来表示对于资源的增删改查
-
使用JSON不使用XML
我举个例子：
网站：/get_user?id=3
RESTFul: GET /user/3 (GET是HTTP类型)
有些同学可能会说，GET、POST我也经常用啊。但是在网站里的GET和POST同RESTFul中的GET、POST是不一样的。网站里使用GET、POST的选择点在于，简单的用GET、复杂对象用POST；但在REST里，GET对应的是查询一个资源，而POST对应的是新增一个资源，意义是决然不同的。理解这一点非常重要。
好，我们接着来看一看RESTFul API的一些最佳实践原则：
- 使用HTTP动词表示增删改查资源， GET：查询，POST：新增，PUT：更新，DELETE：删除
- 返回结果必须使用JSON
- HTTP状态码，在REST中都有特定的意义：200，201,202,204,400,401,403,500。比如401表示用户身份认证失败，403表示你验证身份通过了，但这个资源你不能操作。
- 如果出现错误，返回一个错误码。比如我通常是这么定义的：
- API必须有版本的概念，v1，v2，v3
- 使用Token令牌来做用户身份的校验与权限分级，而不是Cookie。
- url中大小写不敏感，不要出现大写字母
- 使用 - 而不是使用 _ 做URL路径中字符串连接。
- 有一份漂亮的文档~（很重要）
以上只是列出了RESTFul的部分实践原则，并非全部。 给出一个典型的RESTFul API设计风格：
https://api.z.cn/v1/product/recent?page=3&size=20
作者：7七月
链接：http://www.imooc.com/article/17650
来源：慕课网
本文原创发布于慕课网 ，转载请注明出处，谢谢合作
