RESTful API学习记录

411 阅读1分钟

6大限制

  1. C-S(各自处理各自的内容,使任务变得简单)
  2. 无状态(在服务端不要存储会话信息,在接口传参数时,将需要的参数都传过去)
  3. 缓存(响应的都注明是否可以缓存)
  4. 统一接口(接口格式统一)
  5. 分层系统(只让相邻系统通信,不要夸系统通信)
  6. 按需代码

规范

1.使用http动词

   常用:

  1. get(获取数据)
  2. post(创建)
  3. put(更新所有字段)
  4. patch(更新某个字段)
  5. delete(删除)

   不常用:

  1. options(获取可用方法)
  2. head

2.返回结果

  1. get(返回列表(数组)或者单个对象)
  2. post(返回新生成的资源对象)
  3. put(返回更新的完整资源对象)
  4. patch(返回更新的完整资源对象)
  5. delete(返回空文档)

3.常用状态码

  1. 200(成功)
  2. 204(删除成功)
  3. 400
  4. 401(用户没有权限(令牌,密码错误等))
  5. 403(用户得到授权了,但是访问被禁止了)
  6. 404(请求接口不存在)
  7. 422(请求参数验证错误)
  8. 500(服务器错误,无法判断请求是否成功)