RESTful规范理解

RESTful规范理解

URL定位资源,用HTTP动词(GET,POST,DELETE,DETC)描述操作。
识别(identify)、 表示(represent) 、交互(interact with)。

  • 看url就知道要什么
  • 看http method就知道干什么
  • 看http status就知道结果如何

1. 使用URL定位资源

RESTful风格的URL用于指定资源,URL中只能使用名词的组合来标识资源,原则上不使用"动词"
”资源“是整个RESTful的核心。
示例

  • http://api.helloworld.com/v1/xiaoming/friends 表示获取小明的朋友
  • http://api.helloworld.com/v1/xiaoming/age 表示获取小明的年龄

2. 使用HTTP METHOD标识对资源的操作

  • GET 用来获取资源
  • POST 用来新建资源(也可以用于更新资源)
  • PUT 用来更新资源(也经常用于批量处理,但是不是规范的RESTful风格用法)
  • DELETE 用来删除资源

示例:

  • GET http://api.helloworld.com/v1/xiaoming/friends 表示获取小明的朋友
  • POST http://api.helloworld.com/v1/xiaoming/friends 表示小明新增了好友
  • PUT http://api.helloworld.com/v1/xiaoming/age 表示小明的年龄更新了,又长了一岁
  • DELETE http://api.helloworld.com/v1/xiaoming/friends 表示小明把朋友拉黑了,删除了好友

3. 使用HTTP状态码标识请求的结果

用HTTP Status Code传递Server的状态信息。

  • 200 OK
  • 400 Bad Request
  • 403 Forbidden
  • 404 Not Found
  • 500 Internal Server Error

你可能感兴趣的:(RESTful规范理解)