REST API Demo

URL Demo

增：POST

POST http://example.com/widges
Data:
    name = Foobar

删：DELETE

DELETE http://example.com/widgets/123

改：PUT

PUT http://example.com/widgets/123
Data: 
      name = new Name
      color = blue

查：GET

查看所有部件

GET http://example.com/widgets

查看某一个部件

GET http://example.com/widgets/123

嵌套资源

如果说，我们的某个部件有很多用户使用

列出某个部件的所有用户

GET /widgets/123/users

为某个部件新增一个用户

POST /widgets/123/users
Data:   
    name = Andrew

嵌套资源在URL里是完全兼容的，但是超过两套嵌套就不好了，我们可以使用以ID的形式，例如：

/widgets/123/users/456/sports/789/

替换为

/users/456/sports/789

甚至可以替换成这样：

/sports/789

HTTP状态码

简易总结

2xx = Success（成功）

3xx = Redirect（重定向）

4xx = User error（客户端错误）

5xx = Server error（服务器端错误

重要的几个状态码

请求成功的状态码：

200 – OK (默认的)

201 – Created（已创建）

202 – Accepted (已接受：常用语删除请求)

客户端错误状态码：

400 –请求出错（语法格式有误或服务器无法理解此请求）

401 – 未授权(需要登录)

404 – 找不到 (找不到所请求的文件或脚本)

405 – 不允许此方法(错误的 HTTP方法)

409 – 冲突 (IE尝试以PUT请求创建相同的资源时)

API响应格式

选用JSON

创建一个REST API

API授权认证

OAuth