什么是REST?什么是RESTful?

什么是REST?什么是RESTful?

运维常见的网络故障解决技巧,全在这里了!

什么是REST?什么是RESTful?

 

一、REST泉源

REST:是一组架构约束条件和原则,REST是Roy Thomas Fielding在他2000年的博士论文中提出的。 Roy Thomas Fielding是HTTP协议(1.0版和1.1版)的主要设计者、Apache服务器作者之一、Apache基金会第一任主席

二、什么是REST

REST(Representational State Transfer):显示层状态转移,一种软件架构气概,不是尺度。既然不是尺度,我可以遵守,也可以不遵守!!! 什么是显示层状态转移:

Representational (显示层) 
State Transfer(状态转移):通过HTTP动词实现。
  • 总结:URL定位资源,HTTP动词(GET,POST,PUT,DELETE)形貌操作。

三、什么是RESTful

基于REST构建的API就是RESTful气概

RESTful API书写规范

四、若何设计RESTful气概的API

1.路径设计

在RESTful架构中,每个网址代表一种资源(resource),以是网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表名对应,一般来说,数据库中的表都是同种纪录的”聚集”(collection),以是API中的名词也应该使用复数。 举例来说,有一个API提供动物园(zoo)的信息,还包罗种种动物和雇员的信息,则它的路径应该设计成下面这样。

https://api.example.com/v1/zoos 
https://api.example.com/v1/animals 
https://api.example.com/v1/employees

2.HTTP动词设计

对于资源的具体操作类型,由HTTP动词示意,常用的HTTP动词如下:

请求方式	寄义
GET	获取资源(一项或多项)
POST	新建资源
PUT	更新资源(客户端提供改变后的完整资源)
DELETE	删除资源

若何通过URL和http动词获悉要挪用的功效:

请求方式	寄义
GET	/zoos	列出所有动物园
POST	/zoos	新建一个动物园
GET	/zoos/ID	获取某个指定动物园的信息
PUT	/zoos/ID	更新某个指定动物园的信息(提供该动物园的所有信息)
DELETE	/zoos/ID	删除某个动物园
GET	/zoos/ID/animals	列出某个指定动物园的所有动物
DELETE	/zoos/ID/animals/ID	删除某个指定动物园的指定动物

RESTFul API的一些最佳实践原则:

  1. 使用HTTP动词示意增删改查资源, GET:查询,POST:新增,PUT:更新,DELETE:删除
  2. 返回效果必须使用JSON
  3. HTTP状态码,在REST中都有特定的意义:200,201,202,204,400,401,403。好比401示意用户身份认证失败,403示意你验证身份通过了,但这个资源你不能操作。
  4. 若是泛起错误,返回一个错误码: 10000=通用参数错误10001=资源未找到
  5. API 必须有版本的观点, v1, v2
  6. 使用Token令牌来做用户身份的校验与权限分级
  7. url中大小写不敏感,不要泛起大写字母
  8. 使用中划线而不是使用下划线做URL路径中字符串毗邻
  9. 有一份漂亮的文档

RESTFul API好用吗?

某些情形好用,某些情形不好用。什么情形好用,什么情形不好用呢?

  1. 一个经验性的总结:对于开放的API,好比豆瓣、新浪微博、GitHub,好用,异常合适
  2. 对于内部开发,不好用
  3. REST是一种软件架构气概,不是尺度。既然不是尺度,可以遵守,也可以不遵守!

结论

实践过程中开发人员天真掌握

办公室上网攻略--内网、外网、路由,自主控制

分享到 :
相关推荐

发表评论

登录... 后才能评论