RESTful Api

RESTful是什么

其实RESTful绝大部分内容都是关于API设计时规范推荐的做法,并没有新东西。只要符合REST设计原则的API都可以被称为RESTful。
RESTful的核心就是后端将资源发布为URI,前端通过URI访问资源,并通过HTTP动词表示要对资源进行的操作。这里涉及到一个新概念:资源,后端提供的所有内容都可以被定义为资源。典型的RESTful如下:
GET       /student     //查找所有学生
GET       /student/1  //查找id为1的学生
POST     /student     //新增一个学生
PUT     /student/1     //修改id为1的学生
DELETE  /student/1  //删除id为1的学生

为什么用RESTful

前后端分离主要是以API为界限进行解耦的,这就会产生大量的API,采用RESTful来设计API主要有以下好处:
1、表现力更强,更易于理解
2、RESRful是无状态,所以不管前端是何种设备何种状态都可以无差别的请求资源

怎么用RESTful

1、每个资源使用2个URL,网址中只能有名词
2、对于资源的操作类型由HTTP动词来表示
3、统一的返回结果
4、返回正确的状态码
5、允许通过HTTP内容协商,建议格式预定义为JSON
6、对可选发杂的参数,使用查询字符串(?)
7、返回有用的错误信息(message)
8、非资源请求用动词,这看起似乎和1中的说法有矛盾,但这里指的是非资源,而不是资源

No comments, so go and ...add one

Speak Your Mind

Your email address will not be published. Required fiels are marked *
You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>