RESTful风格设计
URL路径
URL地址尽量使用名词复数,不要使用动词
请求方式
请求同一个URL,采用不同的请求方式,代表要执行不同的操作
请求方式 | 说明 |
---|---|
GET | 获取数据(一个或多个) |
POST | 新增数据 |
PUT | 修改数据 |
DELETE | 删除数据 |
过滤信息
过滤参数可以放在查询字符串中
响应数据
获取一组数据,返回一组数据
新增一组数据,返回新增数据
修改一组数据,返回修改数据
删除数据,返回空
响应数据格式
返回的响应数据格式尽量使用json
响应状态码
200[GET/PUT]:服务器成功返回用户请求的数据
201[POST]:用户新建数据成功
204[DELETE]:用户删除数据成功
400[POST/PUT]:用户发出的请求有错误,服务器没有进行新建或修改数据的操作
404:请求不存在,服务器没有进行操作
500:服务器发生错误