HttpStatus状态码详解

关注

原创 2022-11-23 16:37:39 1.7k 阅读 AI 写同款· GEO 优化 ›

HTTP 402与X402协议：让AI Agent自动完成按量付费的支付引擎 HTTP状态码不仅是请求结果的标记，更可以演化出可编程的支付语义。当AI Agent、多智能体协作成为服务端的主要调用方时，传统API Key和订阅制计费已无法满足高频、小额、自动化交易的诉求。HTTP 402 Payment Required状态码天然适合表达“需要付费才能继续访问”的资源语义，X402协议正是基于这一思路，将询价、授权、验证、放行封装为机器可读的支付闭环。借助报价单（Invoice）和支付凭证（Receipt），调用方Agent可在毫秒级完成比价与付费决策，服务方则通过验签确保资金安全。阅读详情

HttpStatus = {  
        //Informational 1xx  信息
        '100' : 'Continue',  //继续
        '101' : 'Switching Protocols',  //交换协议
 
        //Successful 2xx  成功
        '200' : 'OK',  //OK
        '201' : 'Created',  //创建
        '202' : 'Accepted',  //已接受
        '203' : 'Non-Authoritative Information',  //非权威信息
        '204' : 'No Content',  //没有内容
        '205' : 'Reset Content',  //重置内容
        '206' : 'Partial Content',  //部分内容
 
        //Redirection 3xx  重定向
        '300' : 'Multiple Choices',  //多种选择
        '301' : 'Moved Permanently',  //永久移动
        '302' : 'Found',  //找到
        '303' : 'See Other',  //参见其他
        '304' : 'Not Modified',  //未修改
        '305' : 'Use Proxy',  //使用代理
        '306' : 'Unused',  //未使用
        '307' : 'Temporary Redirect',  //暂时重定向
 
        //Client Error 4xx  客户端错误
        '400' : 'Bad Request',  //错误的请求
        '401' : 'Unauthorized',  //未经授权
        '402' : 'Payment Required',  //付费请求
        '403' : 'Forbidden',  //禁止
        '404' : 'Not Found',  //没有找到
        '405' : 'Method Not Allowed',  //方法不允许
        '406' : 'Not Acceptable',  //不可接受
        '407' : 'Proxy Authentication Required',  //需要代理身份验证
        '408' : 'Request Timeout',  //请求超时
        '409' : 'Conflict',  //指令冲突
        '410' : 'Gone',  //文档永久地离开了指定的位置
        '411' : 'Length Required',  //需要Content-Length头请求
        '412' : 'Precondition Failed',  //前提条件失败
        '413' : 'Request Entity Too Large',  //请求实体太大
        '414' : 'Request-URI Too Long',  //请求URI太长
        '415' : 'Unsupported Media Type',  //不支持的媒体类型
        '416' : 'Requested Range Not Satisfiable',  //请求的范围不可满足
        '417' : 'Expectation Failed',  //期望失败
 
        //Server Error 5xx  服务器错误
        '500' : 'Internal Server Error',  //内部服务器错误
        '501' : 'Not Implemented',  //未实现
        '502' : 'Bad Gateway',  //错误的网关
        '503' : 'Service Unavailable',  //服务不可用
        '504' : 'Gateway Timeout',  //网关超时
        '505' : 'HTTP Version Not Supported'  //HTTP版本不支持
};

来源HttpStatusCode 枚举 (System.Net) | Microsoft Learn

Accepted	202	等效于 HTTP 状态 202。 Accepted 指示已接受请求做进一步处理。
AlreadyReported	208	等效于 HTTP 状态 208。 AlreadyReported 指示已在多状态响应的前面部分枚举了 WebDAV 绑定的成员，并且不再将其包含在内。
Ambiguous	300	等效于 HTTP 状态 300。 Ambiguous 指示请求的信息有多种表示形式。默认操作是将此状态视为重定向，并遵循与此响应关联的 Location 标头的内容。 `Ambiguous` 是 `MultipleChoices` 的同义词。
BadGateway	502	等效于 HTTP 状态 502。 BadGateway 指示中间代理服务器从另一代理或原始服务器接收到错误响应。
BadRequest	400	等效于 HTTP 状态 400。 BadRequest 指示服务器未能识别请求。如果没有其他适用的错误，或者不知道准确的错误或错误没有自己的错误代码，则发送 BadRequest。
Conflict	409	等效于 HTTP 状态 409。 Conflict 指示由于服务器上的冲突而未能执行请求。
Continue	100	等效于 HTTP 状态 100。 Continue 指示客户端可能继续其请求。
Created	201	等效于 HTTP 状态 201。 Created 指示请求导致在响应被发送前创建新资源。
EarlyHints	103	等效于 HTTP 状态 103。 EarlyHints 向客户端指示服务器可能会发送最终响应，其中标头字段包含在信息性响应中。
ExpectationFailed	417	等效于 HTTP 状态 417。 ExpectationFailed 指示服务器未能符合 Expect 标头中给定的预期值。
FailedDependency	424	等效于 HTTP 状态 424。 FailedDependency 指示无法对资源执行该方法，因为请求的操作依赖于其他操作，并且该操作失败。
Forbidden	403	等效于 HTTP 状态 403。 Forbidden 指示服务器拒绝满足请求。
Found	302	等效于 HTTP 状态 302。 Found 指示请求的信息位于 Location 标头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。原始请求方法为 POST 时，重定向的请求将使用 GET 方法。 `Found` 是 `Redirect` 的同义词。
GatewayTimeout	504	等效于 HTTP 状态 504。 GatewayTimeout 指示中间代理服务器在等待来自另一个代理或原始服务器的响应时已超时。
Gone	410	等效于 HTTP 状态 410。 Gone 指示请求的资源不再可用。
HttpVersionNotSupported	505	等效于 HTTP 状态 505。 HttpVersionNotSupported 指示服务器不支持请求的 HTTP 版本。
IMUsed	226	等效于 HTTP 状态 226。 IMUsed 指示服务器已执行对资源的请求，并且响应表示应用于当前实例的一个或多个实例操作的结果。
InsufficientStorage	507	等效于 HTTP 状态 507。 InsufficientStorage 指示服务器无法存储完成请求所需的表示形式。
InternalServerError	500	等效于 HTTP 状态 500。 InternalServerError 指示服务器上发生了一般错误。
LengthRequired	411	等效于 HTTP 状态 411。 LengthRequired 指示缺少必需的 Content-length 标头。
Locked	423	等效于 HTTP 状态 423。 Locked 指示源或目标资源已锁定。
LoopDetected	508	等效于 HTTP 状态 508。 LoopDetected 指示服务器已终止操作，因为它在处理带有“Depth: infinity”的 WebDAV 请求时遇到了无限循环。此状态代码用于与不知道多状态响应正文中出现 208 状态代码 AlreadyReported 的客户端进行后向兼容。
MethodNotAllowed	405	等效于 HTTP 状态 405。 MethodNotAllowed 指示请求的资源上不允许请求方法（POST 或 GET）。
MisdirectedRequest	421	等效于 HTTP 状态 421。 MisdirectedRequest 指示请求被定向到无法生成响应的服务器。
Moved	301	等效于 HTTP 状态 301。 Moved 指示请求的信息已移到 Location 头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。原始请求方法为 POST 时，重定向的请求将使用 GET 方法。 `Moved` 是 `MovedPermanently` 的同义词。
MovedPermanently	301	等效于 HTTP 状态 301。 MovedPermanently 指示请求的信息已移到 Location 头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。 `MovedPermanently` 是 `Moved` 的同义词。
MultipleChoices	300	等效于 HTTP 状态 300。 MultipleChoices 指示请求的信息有多种表示形式。默认操作是将此状态视为重定向，并遵循与此响应关联的 Location 标头的内容。 `MultipleChoices` 是 `Ambiguous` 的同义词。
MultiStatus	207	等效于 HTTP 状态 207。 MultiStatus 指示 Web 分布式创作和版本管理 (WebDAV) 操作期间的单个响应有多个状态代码。响应正文包含描述状态代码的 XML。
NetworkAuthenticationRequired	511	等效于 HTTP 状态 511。 NetworkAuthenticationRequired 指示客户端需要进行身份验证才能获得网络访问权限；它旨在用于拦截用于控制网络访问权限的代理。
NoContent	204	等效于 HTTP 状态 204。 NoContent 指示已成功处理请求并且响应已被设定为无内容。
NonAuthoritativeInformation	203	等效于 HTTP 状态 203。 NonAuthoritativeInformation 指示返回的元信息来自缓存副本而不是源服务器，因此可能不正确。
NotAcceptable	406	等效于 HTTP 状态 406。 NotAcceptable 指示客户端已用 Accept 标头指示将不接受资源的任何可用表示形式。
NotExtended	510	等效于 HTTP 状态 510。 NotExtended 指示服务器需要进一步扩展请求才能使服务器完成该请求。
NotFound	404	等效于 HTTP 状态 404。 NotFound 指示请求的资源不在服务器上。
NotImplemented	501	等效于 HTTP 状态 501。 NotImplemented 指示服务器不支持请求的函数。
NotModified	304	等效于 HTTP 状态 304。 NotModified 指示客户端的缓存副本是最新的。未传输此资源的内容。
OK	200	等效于 HTTP 状态 200。 OK 指示请求成功，且请求的信息包含在响应中。这是最常接收的状态代码。
PartialContent	206	等效于 HTTP 状态 206。 PartialContent 指示响应是包括字节范围的 GET 请求所请求的部分响应。
PaymentRequired	402	等效于 HTTP 状态 402。保留 PaymentRequired 以供将来使用。
PermanentRedirect	308	等效于 HTTP 状态 308。 PermanentRedirect 指示请求信息位于 Location 标头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。原始请求方法为 POST 时，重定向的请求还将使用 POST 方法。
PreconditionFailed	412	等效于 HTTP 状态 412。 PreconditionFailed 指示此请求的条件集失败，并且无法执行该请求。使用条件请求标头设置添加，如：If-Match、If-None-Match 或 If-Unmodified-Since。
PreconditionRequired	428	等效于 HTTP 状态 428。 PreconditionRequired 指示服务器要求的请求为条件请求。
Processing	102	等效于 HTTP 状态 102。 Processing 指示服务器已接受完成请求，但尚未完成该请求。
ProxyAuthenticationRequired	407	等效于 HTTP 状态 407。 ProxyAuthenticationRequired 指示请求的代理要求身份验证。 Proxy-authenticate 标头包含如何执行身份验证的详细信息。
Redirect	302	等效于 HTTP 状态 302。 Redirect 指示请求的信息位于 Location 标头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。原始请求方法为 POST 时，重定向的请求将使用 GET 方法。 `Redirect` 是 `Found` 的同义词。
RedirectKeepVerb	307	等效于 HTTP 状态 307。 RedirectKeepVerb 指示请求信息位于 Location 标头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。原始请求方法为 POST 时，重定向的请求还将使用 POST 方法。 `RedirectKeepVerb` 是 `TemporaryRedirect` 的同义词。
RedirectMethod	303	等效于 HTTP 状态 303。作为 POST 的结果，RedirectMethod 将客户端自动重定向到 Location 标头中指定的 URI。用 GET 生成对 Location 标头所指定的资源的请求。 `RedirectMethod` 是 `SeeOther` 的同义词。
RequestedRangeNotSatisfiable	416	等效于 HTTP 状态 416。 RequestedRangeNotSatisfiable 指示无法返回从资源请求的数据范围，因为范围的开头在资源的开头之前，或因为范围的结尾在资源的结尾之后。
RequestEntityTooLarge	413	等效于 HTTP 状态 413。 RequestEntityTooLarge 指示请求太大，服务器无法处理。
RequestHeaderFieldsTooLarge	431	等效于 HTTP 状态 431。 RequestHeaderFieldsTooLarge 指示服务器不愿意处理请求，因为它的标头字段（单个标头字段或所有标头字段合计）太大。
RequestTimeout	408	等效于 HTTP 状态 408。 RequestTimeout 指示客户端没有在服务器期望请求的时间内发送请求。
RequestUriTooLong	414	等效于 HTTP 状态 414。 RequestUriTooLong 指示 URI 太长。
ResetContent	205	等效于 HTTP 状态 205。 ResetContent 指示客户端应重置（而非重新加载）当前资源。
SeeOther	303	等效于 HTTP 状态 303。作为 POST 的结果，SeeOther 将客户端自动重定向到 Location 标头中指定的 URI。用 GET 生成对 Location 标头所指定的资源的请求。 `SeeOther` 是 `RedirectMethod` 的同义词。
ServiceUnavailable	503	等效于 HTTP 状态 503。 ServiceUnavailable 指示服务器暂时不可用，通常是由于过多加载或维护。
SwitchingProtocols	101	等效于 HTTP 状态 101。 SwitchingProtocols 指示正在更改协议版本或协议。
TemporaryRedirect	307	等效于 HTTP 状态 307。 TemporaryRedirect 指示请求信息位于 Location 标头中指定的 URI 处。接收到此状态时的默认操作为遵循与响应关联的 Location 标头。原始请求方法为 POST 时，重定向的请求还将使用 POST 方法。 `TemporaryRedirect` 是 `RedirectKeepVerb` 的同义词。
TooManyRequests	429	等效于 HTTP 状态 429。 TooManyRequests 指示用户在给定时间内发送了太多请求。
Unauthorized	401	等效于 HTTP 状态 401。 Unauthorized 指示请求的资源要求身份验证。 WWW-Authenticate 标头包含如何执行身份验证的详细信息。
UnavailableForLegalReasons	451	等效于 HTTP 状态 451。 UnavailableForLegalReasons 指示服务器由于法律要求而拒绝访问资源。
UnprocessableEntity	422	等效于 HTTP 状态 422。 UnprocessableEntity 指示请求格式正确，但由于语义错误，无法遵循该请求。
UnsupportedMediaType	415	等效于 HTTP 状态 415。 UnsupportedMediaType 指示请求是不受支持的类型。
Unused	306	等效于 HTTP 状态 306。 Unused 是未完全指定的 HTTP/1.1 规范的建议扩展。
UpgradeRequired	426	等效于 HTTP 状态 426。 UpgradeRequired 指示客户端应切换为诸如 TLS/1.0 之类的其他协议。
UseProxy	305	等效于 HTTP 状态 305。 UseProxy 指示请求应使用位于 Location 标头中指定的 URI 的代理服务器。
VariantAlsoNegotiates	506	等效于 HTTP 状态 506。 VariantAlsoNegotiates 指示所选的变体资源配置为参与透明内容协商本身，因此在协商过程中不是正确的终结点。