状态代码 状态描述 业务场景
101 Switching Protocols 当协议从Http切换成其他协议如WebSocket时,服务端返回相关信息,并告知客户端Upgrade消息头通知其应该切换的协议名。
102 Processing 当前端发起异步任务请求时,如果前端需要查询任务状态,异步任务未完成时采取该状态代码进行处理。
200 OK 请求成功:SUCCESS。
201 Created 通知客户端该资源已被创建,目前版本暂不支持Location头信息,当用户在重复请求创建某一资源时使用该状态代码进行标识,该状态需要实现HTTP的幂等性。
204 No Content 针对服务端有可能在返回值部分出现的空指针异常NullPointerException采用204代码通知客户端无任何响应数据,该状态代码限制开发人员考虑这种异常的专用情况,解决Java中的NullPointer常见错误。
302 Move temporarily 当平台版本从v1开始升级成v2过程中,禁用v1时的专用状态代码,迁移过程中提示用户该API已进入升级流程。
303 See Other 当平台版本升级完成后,客户端再访问v1的API时,该API有可能已经不存在,此时提供响应状态告诉客户端已经改变的API详细描述信息。
400 Bad Request 请求前置验证语义问题,一般处理参数验证(是否必须、类型不合法、值不合法、序列化异常)等通用性请求验证异常信息。
401 Unauthorized 认证异常
403 Forbidden 权限不足,授权异常
404 Not Found 资源无法找到(注意和302, 303进行区分)
405 Method Not Allowed 通知客户端重新发送请求,并带上Allow头信息高速客户端重新发送请求的方法信息。
406 Not Acceptable 【响应流程处理】判断客户端Accept头信息,并根据Accept做出服务端的合适选择,如果无法处理客户端Accept中的信息,告知客户端该媒体类型无法解析,包括Accept-*类型的所有系列。
408 Request Timeout 用于处理两种请求:路由Api Gateway服务在查找其他服务过程中,无法在预定时间内给出合适响应,则给出408异常。服务本身在处理大数据量任务,该任务超过了服务定制的时间上限,则通知客户端超时,并提示访问该任务的状态查询地址(可返回200和102的状态检索地址信息)
412 Precondition Failed 对于平台和应用的转发性请求过程中,如果请求未通过平台本身验证,直接发送到平台中的内部请求地址,则判定为:先决条件不满足,不予响应。
413 Request Entity Too Large 附件上传文件越界、数据量越界、则提供该状态代码。
415 Unsupported Media Type 【请求处理流程】根据客户端提供的Content-Type信息,服务端无法给出对应的解析方式,则提供415异常,包括encoding,language等所有Content-*类型的请求无法处理时专用。
421 too many connections 熔断、限流、服务降级时专用异常代码,不运行接收新请求。
423 Locked 当两个请求同时更新一条资源信息时,多用于PUT请求中,后发送的请求告诉客户端该资源被锁定。
424 Failed Dependency 出现第三方依赖接口错误专用异常,如服务端访问了第三方的接口,如云证、底账库、七牛等。
449 Retry With 一般可用于未通过认证,数据格式不合法,以及字段锁定,在允许重试的接口中使用该状态代码进行说明。
451 Unavailable For Legal Reasons 该请求资源具有敏感信息或法律风险导致请求不可用。
500 Internal Server Error 服务器内部错误,代码异常情况依靠该错误。
501 Not Implemented 临时接口(该接口可能处于开发过程中)。
503 Service Unavaible 服务临时挂掉,等待恢复时使用该状态代码进行说明。

results matching ""

    No results matching ""