请我喝杯咖啡
开发

HTTP 状态码

包含所有 HTTP 状态码及其描述的参考指南。 在你的设备上运行——不上传、不存储任何内容。

显示 50 / 50 个状态码
100
Continue
1xx

客户端应继续发送请求。用于告知客户端请求的初始部分已收到。

用例: 服务器确认部分请求;客户端应继续发送。
101
Switching Protocols
1xx

服务器正在根据客户端请求切换到不同的协议。

用例: 从 HTTP 升级到 WebSocket 握手。
102
Processing
1xx

服务器已收到并正在处理请求,但尚无响应可用。

用例: 防止长时间运行的 WebDAV 请求超时。
103
Early Hints
1xx

在最终 HTTP 消息之前返回一些响应头。

用例: 在完整响应准备好之前预加载资源。
200
OK
2xx

请求成功。含义取决于使用的 HTTP 方法。

用例: 成功的 GET、POST、PUT、DELETE 的标准响应。
201
Created
2xx

请求成功,并因此创建了新资源。

用例: 成功创建新用户或记录的 POST 请求。
202
Accepted
2xx

请求已收到但尚未处理。处理是异步进行的。

用例: 通过 API 触发后台作业或异步任务。
203
Non-Authoritative Information
2xx

返回的元数据不是来自源服务器,而是来自本地或第三方副本。

用例: 代理服务器转换或缓存响应。
204
No Content
2xx

请求成功,但响应中没有内容可发送。

用例: 不需要返回数据的 DELETE 或 PUT。
206
Partial Content
2xx

由于客户端发送了范围头,服务器仅交付资源的一部分。

用例: 视频流或可恢复文件下载。
207
Multi-Status
2xx

WebDAV 中多个子请求的多个状态码。

用例: 包含多个资源状态的 WebDAV PROPFIND 响应。
208
Already Reported
2xx

DAV 绑定的成员已在先前的回复中枚举。

用例: 避免重复成员的 WebDAV 响应。
226
IM Used
2xx

服务器完成了 GET 请求,响应是实例操作的结果。

用例: HTTP 响应中的增量编码。
301
Moved Permanently
3xx

请求资源的 URL 已永久更改。新 URL 在响应中给出。

用例: 对SEO友好 从旧 URL 到新 URL 的永久重定向。
302
Found
3xx

请求资源的 URL 已临时更改。之后可能还会发生更改。

用例: 页面更新期间的临时重定向。
303
See Other
3xx

服务器发送此响应以指示客户端使用 GET 请求从另一个 URI 获取请求的资源。

用例: POST 表单提交后的重定向。
304
Not Modified
3xx

用于缓存。告知客户端响应未更改,因此可以使用其缓存版本。

用例: 使用 ETag 或 Last-Modified 头的浏览器缓存验证。
307
Temporary Redirect
3xx

服务器发送此响应以指示客户端使用相同方法从另一个 URI 获取请求的资源。

用例: 保留原始 HTTP 方法的临时重定向。
308
Permanent Redirect
3xx

保留原始请求中使用的 HTTP 方法的永久重定向。

用例: 保留 POST 方法的永久 API 端点迁移。
400
Bad Request
4xx

由于语法错误或无效的请求消息框架,服务器无法处理请求。

用例: 无效的 JSON 主体或缺少必需的查询参数。
401
Unauthorized
4xx

需要身份验证但未提供或无效。

用例: 没有有效令牌或会话的 API 请求。
402
Payment Required
4xx

保留供将来使用;有时用于数字付款要求。

用例: 需要付费墙或订阅才能访问内容。
403
Forbidden
4xx

客户端没有访问内容的权限。与 401 不同,身份是已知的。

用例: 已认证用户尝试访问仅限管理员的资源。
404
Not Found
4xx

服务器找不到请求的资源。URL 未被识别。

用例: 访问不存在的页面或资源。
405
Method Not Allowed
4xx

请求方法是已知的,但目标资源不支持。

用例: 向仅支持 GET 的端点发送 DELETE。
406
Not Acceptable
4xx

服务器无法生成与请求头中定义的可接受值列表匹配的响应。

用例: API 仅返回 JSON 但客户端要求 XML。
408
Request Timeout
4xx

服务器在准备等待的时间内未收到完整的请求消息。

用例: 客户端发送请求主体耗时过长。
409
Conflict
4xx

请求与服务器当前状态冲突。

用例: 尝试创建已存在的用户名。
410
Gone
4xx

目标资源不再可用,且不会再可用。

用例: 永久删除的内容,没有转发地址。
411
Length Required
4xx

服务器拒绝请求,因为缺少 Content-Length 头字段。

用例: 没有 Content-Length 头的 POST 请求。
413
Payload Too Large
4xx

服务器拒绝请求,因为请求主体大于服务器愿意处理的大小。

用例: 文件上传超过最大允许大小。
414
URI Too Long
4xx

客户端请求的 URI 比服务器愿意解释的长度更长。

用例: GET 请求中极长的查询字符串。
415
Unsupported Media Type
4xx

服务器拒绝接受请求,因为请求主体格式不受支持。

用例: 向仅接受 JSON 的 API 端点发送 XML。
422
Unprocessable Entity
4xx

服务器理解内容类型但无法处理指令。

用例: JSON 有效但字段值无效的表单数据。
423
Locked
4xx

正在访问的资源已锁定。

用例: 另一个用户锁定的 WebDAV 资源。
425
Too Early
4xx

表示服务器不愿意冒险处理可能被重放的请求。

用例: TLS 1.3 连接中的早期数据。
429
Too Many Requests
4xx

用户在给定时间内发送了过多请求(速率限制)。

用例: 超出 API 速率限制;客户端应退避。
431
Request Header Fields Too Large
4xx

服务器拒绝处理请求,因为头字段过大。

用例: Cookie 或自定义头超出服务器限制。
451
Unavailable For Legal Reasons
4xx

由于法律要求,服务器拒绝访问资源。

用例: 因 DMCA 下架或法律命令而阻止的内容。
500
Internal Server Error
5xx

服务器遇到了不知道如何处理的情况。

用例: 服务器端代码中的未处理异常。
501
Not Implemented
5xx

服务器不支持请求方法,无法处理。

用例: 服务器不支持资源上的 PATCH 方法。
502
Bad Gateway
5xx

作为网关的服务器从上游服务器收到了无效响应。

用例: Nginx 从后端应用服务器收到错误响应。
503
Service Unavailable
5xx

服务器尚未准备好处理请求。常见原因是维护中或过载。

用例: 服务器维护中或流量过大。
504
Gateway Timeout
5xx

作为网关的服务器未从上游服务器及时收到响应。

用例: 上游 API 响应耗时过长。
505
HTTP Version Not Supported
5xx

请求中使用的 HTTP 版本不受服务器支持。

用例: 客户端使用 HTTP/3 而服务器仅支持 HTTP/1.1。
506
Variant Also Negotiates
5xx

服务器在透明内容协商中存在内部配置错误。

用例: 服务器上配置错误的内容协商。
507
Insufficient Storage
5xx

服务器无法存储完成请求所需的表示。

用例: WebDAV 服务器存储空间不足。
508
Loop Detected
5xx

服务器在处理请求时检测到无限循环。

用例: 创建循环引用的 WebDAV 请求。
510
Not Extended
5xx

服务器需要进一步扩展请求才能满足它。

用例: 客户端需要发送 HTTP 扩展框架请求。
511
Network Authentication Required
5xx

客户端需要进行身份验证以获得网络访问权限。

用例: 需要登录后才能访问互联网的强制门户。