1xx信息响应4 条100Continue请求已收到,服务器正在继续处理,前端一般较少直接感知。服务器已收到请求头,客户端可以继续发送请求体。点击查看说明101Switching Protocols请求已收到,服务器正在继续处理,前端一般较少直接感知。服务器同意切换协议。点击查看说明102Processing请求已收到,服务器正在继续处理,前端一般较少直接感知。服务器已接收请求,但仍在处理中。点击查看说明103Early Hints请求已收到,服务器正在继续处理,前端一般较少直接感知。正式响应前先返回部分提示头。点击查看说明
2xx成功响应5 条200OK请求成功完成,接口和资源状态符合预期。请求成功。场景:GET、PUT、PATCH 成功时常见。201Created请求成功完成,接口和资源状态符合预期。资源已创建。场景:POST 创建资源成功。202Accepted请求成功完成,接口和资源状态符合预期。请求已接收,但还未处理完成。场景:异步任务入队。204No Content请求成功完成,接口和资源状态符合预期。请求成功,但没有返回内容。场景:DELETE 成功、更新成功但无需返回体。206Partial Content请求成功完成,接口和资源状态符合预期。返回资源的部分内容。场景:断点续传、视频分段加载。
3xx重定向6 条300Multiple Choices资源需要重定向或走缓存逻辑,常见于跳转和缓存协商。请求对应多个可用响应。点击查看说明301Moved Permanently资源需要重定向或走缓存逻辑,常见于跳转和缓存协商。资源已永久移动。场景:网站迁移、URL 永久变更。302Found资源需要重定向或走缓存逻辑,常见于跳转和缓存协商。资源临时重定向。场景:登录后跳转、临时跳转。304Not Modified资源需要重定向或走缓存逻辑,常见于跳转和缓存协商。资源未修改,可直接使用缓存。场景:浏览器缓存协商成功。307Temporary Redirect资源需要重定向或走缓存逻辑,常见于跳转和缓存协商。临时重定向,且保持原请求方法。点击查看说明308Permanent Redirect资源需要重定向或走缓存逻辑,常见于跳转和缓存协商。永久重定向,且保持原请求方法。点击查看说明
4xx客户端错误11 条400Bad Request客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求格式错误或参数非法。场景:JSON 解析失败、必填参数缺失。401Unauthorized客户端请求本身有问题,通常要先检查参数、权限、地址或频率。未通过身份认证。场景:未登录、Token 过期。403Forbidden客户端请求本身有问题,通常要先检查参数、权限、地址或频率。已识别身份,但没有访问权限。场景:角色权限不足、IP 被限制。404Not Found客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求的资源不存在。场景:路径错误、资源已删除。405Method Not Allowed客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求方法不被允许。场景:接口只支持 GET,却发了 POST。408Request Timeout客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求超时。点击查看说明409Conflict客户端请求本身有问题,通常要先检查参数、权限、地址或频率。当前资源状态与请求冲突。场景:重复创建、版本冲突。410Gone客户端请求本身有问题,通常要先检查参数、权限、地址或频率。资源曾存在,但已被永久移除。点击查看说明413Payload Too Large客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求体过大。场景:上传文件超限。429Too Many Requests客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求频率过高,触发限流。场景:高频轮询、批量并发请求。431Request Header Fields Too Large客户端请求本身有问题,通常要先检查参数、权限、地址或频率。请求头过大。点击查看说明
5xx服务端错误8 条500Internal Server Error服务端内部或网关层异常,重点看日志、依赖服务和超时链路。服务器内部异常。场景:代码异常、数据库执行失败。501Not Implemented服务端内部或网关层异常,重点看日志、依赖服务和超时链路。服务器不支持当前功能。点击查看说明502Bad Gateway服务端内部或网关层异常,重点看日志、依赖服务和超时链路。网关从上游收到无效响应。场景:反向代理、网关转发后端失败。503Service Unavailable服务端内部或网关层异常,重点看日志、依赖服务和超时链路。服务当前不可用。场景:维护中、过载保护。504Gateway Timeout服务端内部或网关层异常,重点看日志、依赖服务和超时链路。网关等待上游超时。场景:后端慢查询、依赖响应过慢。505HTTP Version Not Supported服务端内部或网关层异常,重点看日志、依赖服务和超时链路。服务器不支持当前 HTTP 版本。点击查看说明507Insufficient Storage服务端内部或网关层异常,重点看日志、依赖服务和超时链路。服务器存储空间不足。点击查看说明508Loop Detected服务端内部或网关层异常,重点看日志、依赖服务和超时链路。检测到循环处理。点击查看说明