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