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