为什么要用Restful API

RESTful架构遵循统一接口原则,不论什么样的资源,都是通过使用相同的接口进行资源的访问。接口应该使用标准的HTTP方法如GET,PUT和POST,并遵循这些方法的语义。

请求

一般来说,url不应该使用动作来描述。例如,下面是一些不符合统一接口要求的url:

  • GET /getUser/1
  • POST /createUser
  • PUT /updateUser/1
  • DELETE /deleteUser/1

RESTful 的核心思想就是,客户端发出的数据操作指令都是"动词 + 宾语"的结构。比如,GET /articles这个命令,GET是动词,/articles是宾语。

状态码

一般的api都是以200来表示成功。我们同样可以用精确的状态码来表示成功。

  • GET: 200 OK
  • POST: 201 Created
  • PUT: 200 OK
  • PATCH: 200 OK
  • DELETE: 204 No Content

用一句话来描述restful api 就是URL定位资源,用HTTP动词(GET,POST,PUT,DELETE)描述操作。

下面是正确的restful api用法:

  • GET /blog/Articles 获取所有文章
  • GET /blog/Article/1 获取id为1的文章
  • POST /blog/Articles 添加一篇文章
  • PUT /blog/Articles 修改一篇文章
  • DELETE /blog/Articles/1 删除id为1的文章
Logo

CSDN联合极客时间,共同打造面向开发者的精品内容学习社区,助力成长!

更多推荐