1. 服务器向用户返回的状态码和提示信息,常见的有以下一些(方括号中是该状态码对应的HTTP动词)
状态码 | 请求类型 | 语义 |
---|---|---|
200 OK | [GET] | 服务器成功返回用户请求的数据,该操作是幂等的(Idempotent)。 |
201 CREATED | [POST/PUT/PATCH] | 用户新建或修改数据成功。 |
202 Accepted | [*] | 表示一个请求已经进入后台排队(异步任务) |
204 NO CONTENT | [DELETE] | 用户删除数据成功。 |
400 INVALID REQUEST | [POST/PUT/PATCH] | :用户发出的请求有错误,服务器没有进行新建或修改数据的操作,该操作是幂等的。 |
401 Unauthorized | [*] | 表示用户没有权限(令牌、用户名、密码错误)。 |
403 Forbidden | [*] | 表示用户得到授权(与401错误相对),但是访问是被禁止的。 |
404 NOT FOUND | [*] | 用户发出的请求针对的是不存在的记录,服务器没有进行操作,该操作是幂等的。 |
406 Not Acceptable | [GET] | 用户请求的格式不可得(比如用户请求JSON格式,但是只有XML格式)。 |
410 Gone | [GET] | 用户请求的资源被永久删除,且不会再得到的。 |
422 Unprocesable entity | [POST/PUT/PATCH] | 当创建一个对象时,发生一个验证错误。 |
500 INTERNAL SERVER ERROR | [*] | 服务器发生错误,用户将无法判断发出的请求是否成功。 |
2. 常用的http状态码及使用场景:
状态码 | 使用场景 |
---|---|
400 bad request | 常用在参数校验 |
401 unauthorized | 未经验证的用户,常见于未登录。如果经过验证后依然没权限,应该 403(即 authentication和 authorization的区别)。 |
403 forbidden | 无权限 |
404 not found | 资源不存在 |
500 internal server error | 非业务类异常 |
503 service unavaliable | 由容器抛出,自己的代码不要抛这个异常 |