RESTful API是什么?

1. REST 是Repersentational State Transfer的缩写

翻译为"表述性状态传递",那么什么是表述性状态传递呢?为了理解这个词语,咱们从"RESTful是什么"这个问题开始讲起。编程

REST不是标准,是一种设计风格。按照这个设计风格设计出来的API,就叫REST API。api

2. 全部的东西都是资源,全部操做都经过对资源的增删改查(CURD)实现

这个学过编程的应该很好理解,万物皆对象,在REST中就是"万物皆资源",每一个资源对应一个惟一的全局资源的定位符(URI),资源是整个REST的基础。其次,就是客户端能够对资源进行管理,全部的管理操做都是经过HTTP的Action来实现。服务器

3. 对资源的增删改查对应URL的操做(POST,DELETE,PUT,GET)

4. 全部操做都是无状态的

也就是不要使用Sessionrestful

RESTful API示例

下面举几个RESTful API的例子,假设下面是一个学校学生信息的项目post

  • URL: http://localhost/student
  • GET /student 获取学生列表
  • POST /student 新学员报到
  • GET /student/110 获取ID为110的学生信息
  • PUT /student/110 修改ID为110的学生信息
  • DELETE /student/110 删除ID为110的学生信息
  • GET /student/110/home 获取ID为110的学生的家庭信息

登陆/注销该怎么设计API呢?

思考一下,咱们登陆,确定是为了登陆后作某些操做,实际上就是向服务器请求一些受权。那么注销呢,就是请求服务器删除这个受权。因此不难理解:url

POST /teacher 登陆翻译

DELETE /teacher 注销设计

URI命名总结规律就是:

/资源名称rest

/资源名称/{资源ID}对象

/资源名称/{资源ID}/子资源名称

/资源名称/{资源ID}/子资源名称/{子资源ID}

相关文章
相关标签/搜索