Documentation
¶
Index ¶
Constants ¶
View Source
const ( HeaderAuthorization = "Authorization" // HTTP 请求头字段，携带认证信息 HeaderProxyAuthenticate = "Proxy-Authenticate" // HTTP 响应头字段，要求客户端提供认证信息以访问代理服务器 HeaderProxyAuthorization = "Proxy-Authorization" // HTTP 请求头字段，携带代理服务器的认证信息 HeaderWWWAuthenticate = "WWW-Authenticate" // HTTP 响应头字段，表示服务器要求客户端进行认证 HeaderAge = "Age" // HTTP 响应头字段，表示从原始服务器生成响应以来的秒数 HeaderCacheControl = "Cache-Control" // HTTP 请求/响应头字段，用于指定缓存机制 HeaderClearSiteData = "Clear-Site-Data" // HTTP 响应头字段，清除用户数据（如缓存、cookies） HeaderExpires = "Expires" // HTTP 响应头字段，指定响应过期的日期和时间 HeaderPragma = "Pragma" // HTTP 请求/响应头字段，控制缓存机制 HeaderWarning = "Warning" // HTTP 响应头字段，提供关于缓存或状态的警告信息 HeaderAcceptCH = "Accept-CH" // HTTP 响应头字段，指定客户端提示的字段 HeaderAcceptCHLifetime = "Accept-CH-Lifetime" // HTTP 响应头字段，指定客户端提示的字段的生存时间 HeaderContentDPR = "Content-DPR" // HTTP 响应头字段，指定内容的设备像素比 HeaderDPR = "DPR" // HTTP 请求头字段，指定客户端的设备像素比 HeaderEarlyData = "Early-Data" // HTTP 请求头字段，指示请求使用的是 0-RTT 早期数据 HeaderSaveData = "Save-Data" // HTTP 请求头字段，表示客户端想要保存数据 HeaderViewportWidth = "Viewport-Width" // HTTP 请求头字段，指定客户端的视口宽度 HeaderWidth = "Width" // HTTP 请求头字段，指定资源的显示宽度 HeaderETag = "ETag" // HTTP 响应头字段，提供资源的实体标签（ETag） HeaderIfMatch = "If-Match" // HTTP 请求头字段，仅在给定的实体标记匹配时执行请求 HeaderIfModifiedSince = "If-Modified-Since" // HTTP 请求头字段，仅在给定日期后资源被修改时执行请求 HeaderIfNoneMatch = "If-None-Match" // HTTP 请求头字段，指示仅在不匹配给定的实体标签时返回资源 HeaderIfUnmodifiedSince = "If-Unmodified-Since" // HTTP 请求头字段，仅在给定日期后资源未被修改时执行请求 HeaderLastModified = "Last-Modified" // HTTP 响应头字段，指示资源的最后修改日期 HeaderVary = "Vary" // HTTP 响应头字段，指示缓存如何根据请求头部字段生成缓存副本 HeaderConnection = "Connection" // HTTP 请求/响应头字段，控制连接管理（例如保持连接） HeaderKeepAlive = "Keep-Alive" // HTTP 响应头字段，控制持久连接的参数 HeaderAccept = "Accept" // HTTP 请求头字段，指定客户端可接受的响应媒体类型 HeaderAcceptCharset = "Accept-Charset" // HTTP 请求头字段，指定客户端可接受的字符集 HeaderAcceptEncoding = "Accept-Encoding" // HTTP 请求头字段，指定客户端可接受的内容编码 HeaderAcceptLanguage = "Accept-Language" // HTTP 请求头字段，指定客户端可接受的语言 HeaderCookie = "Cookie" // HTTP 请求头字段，向服务器发送客户端的 cookies HeaderExpect = "Expect" // HTTP 请求头字段，指示客户端期望服务器的行为 HeaderMaxForwards = "Max-Forwards" // HTTP 请求头字段，指定请求可以通过的代理服务器或网关的最大数量 HeaderSetCookie = "Set-Cookie" // HTTP 响应头字段，指示服务器向客户端设置 cookies HeaderAccessControlAllowCredentials = "Access-Control-Allow-Credentials" // CORS 响应头字段，指示是否可以使用凭据 HeaderAccessControlAllowHeaders = "Access-Control-Allow-Headers" // CORS 响应头字段，指定可以在实际请求中使用的首部字段 HeaderAccessControlAllowMethods = "Access-Control-Allow-Methods" // CORS 响应头字段，指定实际请求可以使用的 HTTP 方法 HeaderAccessControlAllowOrigin = "Access-Control-Allow-Origin" // CORS 响应头字段，指定允许访问资源的来源 HeaderAccessControlExposeHeaders = "Access-Control-Expose-Headers" // CORS 响应头字段，指定可以访问的响应头字段 HeaderAccessControlMaxAge = "Access-Control-Max-Age" // CORS 响应头字段，指定预检请求的结果可以缓存的时间 HeaderAccessControlRequestHeaders = "Access-Control-Request-Headers" // CORS 请求头字段，指定在实际请求中使用的首部字段 HeaderAccessControlRequestMethod = "Access-Control-Request-Method" // CORS 请求头字段，指定在实际请求中使用的 HTTP 方法 HeaderOrigin = "Origin" // HTTP 请求头字段，指示请求的来源 HeaderTimingAllowOrigin = "Timing-Allow-Origin" // HTTP 响应头字段，指定允许访问资源时间数据的来源 HeaderXPermittedCrossDomainPolicies = "X-Permitted-Cross-Domain-Policies" // HTTP 响应头字段，指定允许跨域策略文件的类型 HeaderDNT = "DNT" // HTTP 请求头字段，表示用户不希望被跟踪 HeaderTk = "Tk" // HTTP 响应头字段，表示跟踪状态 HeaderContentDisposition = "Content-Disposition" // HTTP 响应头字段，指定内容的呈现方式（如附件） HeaderContentEncoding = "Content-Encoding" // HTTP 响应头字段，指定内容的编码方式 HeaderContentLanguage = "Content-Language" // HTTP 响应头字段，指定内容的语言 HeaderContentLength = "Content-Length" // HTTP 请求/响应头字段，指示请求或响应主体的字节长度 HeaderContentLocation = "Content-Location" // HTTP 响应头字段，指示资源的替代位置 HeaderContentType = "Content-Type" // HTTP 请求/响应头字段，指定请求或响应主体的媒体类型 HeaderForwarded = "Forwarded" // HTTP 请求头字段，表示代理服务器的传递信息 HeaderVia = "Via" // HTTP 请求/响应头字段，表示代理或网关服务器的传递信息 HeaderXForwardedFor = "X-Forwarded-For" // HTTP 请求头字段，表示客户端的 IP 地址（通过代理服务器） HeaderXForwardedHost = "X-Forwarded-Host" // HTTP 请求头字段，表示客户端的原始主机 HeaderXForwardedProto = "X-Forwarded-Proto" // HTTP 请求头字段，表示客户端的原始协议（HTTP 或 HTTPS） HeaderXForwardedProtocol = "X-Forwarded-Protocol" // HTTP 请求头字段，表示客户端的原始协议（HTTP 或 HTTPS） HeaderXForwardedSsl = "X-Forwarded-Ssl" // HTTP 请求头字段，表示客户端是否使用 SSL（通过代理服务器） HeaderXUrlScheme = "X-Url-Scheme" // HTTP 请求头字段，表示请求的 URL 协议 HeaderLocation = "Location" // HTTP 响应头字段，指示资源的重定向位置 HeaderFrom = "From" // HTTP 请求头字段，表示请求发起者的电子邮件地址 HeaderHost = "Host" // HTTP 请求头字段，指定请求目标的主机和端口号 HeaderReferer = "Referer" // HTTP 请求头字段，表示当前请求的来源 HeaderReferrerPolicy = "Referrer-Policy" // HTTP 请求头字段，控制 Referer 头字段的发送 HeaderUserAgent = "User-Agent" // HTTP 请求头字段，表示客户端的用户代理信息 HeaderAllow = "Allow" // HTTP 响应头字段，指定资源支持的 HTTP 方法 HeaderServer = "Server" // HTTP 响应头字段，表示服务器软件的信息 HeaderAcceptRanges = "Accept-Ranges" // HTTP 响应头字段，指示服务器支持的范围请求 HeaderContentRange = "Content-Range" // HTTP 响应头字段，指示部分响应的范围 HeaderIfRange = "If-Range" // HTTP 请求头字段，指示在指定的实体标记匹配时执行范围请求 HeaderRange = "Range" // HTTP 请求头字段，指定请求的字节范围 HeaderContentSecurityPolicy = "Content-Security-Policy" // HTTP 响应头字段，定义内容安全策略 HeaderContentSecurityPolicyReportOnly = "Content-Security-Policy-Report-Only" // HTTP 响应头字段，定义内容安全策略（仅报告模式） HeaderCrossOriginResourcePolicy = "Cross-Origin-Resource-Policy" // HTTP 响应头字段，控制跨域资源策略 HeaderExpectCT = "Expect-CT" // HTTP 响应头字段，指示证书透明性策略 HeaderFeaturePolicy = "Feature-Policy" // HTTP 响应头字段，控制浏览器特性策略 HeaderPublicKeyPins = "Public-Key-Pins" // HTTP 响应头字段，表示公钥钉扎策略 HeaderPublicKeyPinsReportOnly = "Public-Key-Pins-Report-Only" // HTTP 响应头字段，表示公钥钉扎策略（仅报告模式） HeaderStrictTransportSecurity = "Strict-Transport-Security" // HTTP 响应头字段，指示浏览器强制使用 HTTPS 访问 HeaderUpgradeInsecureRequests = "Upgrade-Insecure-Requests" // HTTP 请求头字段，表示客户端愿意接收 HTTPS 响应 HeaderXContentTypeOptions = "X-Content-Type-Options" // HTTP 响应头字段，防止 MIME 类型嗅探 HeaderXDownloadOptions = "X-Download-Options" // HTTP 响应头字段，防止下载文件自动执行 HeaderXFrameOptions = "X-Frame-Options" // HTTP 响应头字段，防止网页被嵌入到 iframe 中 HeaderXPoweredBy = "X-Powered-By" // HTTP 响应头字段，指示服务器使用的技术栈 HeaderXXSSProtection = "X-XSS-Protection" // HTTP 响应头字段，启用 XSS 过滤 HeaderLastEventID = "Last-Event-ID" // HTTP 请求头字段，指定最后一个事件 ID HeaderNEL = "NEL" // HTTP 响应头字段，表示网络错误日志的策略 HeaderPingFrom = "Ping-From" // HTTP 请求头字段，指示 Ping 请求的来源 HeaderPingTo = "Ping-To" // HTTP 请求头字段，指示 Ping 请求的目标 HeaderReportTo = "Report-To" // HTTP 响应头字段，表示错误报告的目标 HeaderTE = "TE" // HTTP 请求头字段，指定传输编码的接受方式 HeaderTrailer = "Trailer" // HTTP 请求/响应头字段，指定在消息主体之后传输的头字段 HeaderTransferEncoding = "Transfer-Encoding" // HTTP 响应头字段，指示传输编码方式（如分块编码） HeaderSecWebSocketAccept = "Sec-WebSocket-Accept" // WebSocket 响应头字段，表示接受的 WebSocket 连接 HeaderSecWebSocketExtensions = "Sec-WebSocket-Extensions" // WebSocket 响应头字段，表示使用的 WebSocket 扩展 HeaderSecWebSocketKey = "Sec-WebSocket-Key" // WebSocket 请求头字段，表示客户端生成的密钥 HeaderSecWebSocketProtocol = "Sec-WebSocket-Protocol" // WebSocket 请求头字段，表示使用的 WebSocket 子协议 HeaderSecWebSocketVersion = "Sec-WebSocket-Version" // WebSocket 请求头字段，表示使用的 WebSocket 协议版本 HeaderAcceptPatch = "Accept-Patch" // HTTP 响应头字段，指示服务器支持的部分更新方法 HeaderAcceptPushPolicy = "Accept-Push-Policy" // HTTP 响应头字段，表示客户端可接受的推送策略 HeaderAcceptSignature = "Accept-Signature" // HTTP 响应头字段，表示客户端支持的签名算法 HeaderAltSvc = "Alt-Svc" // HTTP 响应头字段，表示替代服务的信息 HeaderDate = "Date" // HTTP 请求/响应头字段，指示消息发送的日期和时间 HeaderIndex = "Index" // HTTP 请求头字段，指定索引页 HeaderLargeAllocation = "Large-Allocation" // HTTP 响应头字段，表示为大分配提供的内存大小 HeaderLink = "Link" // HTTP 响应头字段，表示文档的关系类型 HeaderPushPolicy = "Push-Policy" // HTTP 响应头字段，表示服务器使用的推送策略 HeaderRetryAfter = "Retry-After" // HTTP 响应头字段，表示客户端应等待的时间 HeaderServerTiming = "Server-Timing" // HTTP 响应头字段，表示服务器端性能的指标 HeaderSignature = "Signature" // HTTP 请求/响应头字段，表示请求或响应的数字签名 HeaderSignedHeaders = "Signed-Headers" // HTTP 响应头字段，指示签名的 HTTP 头字段 HeaderSourceMap = "SourceMap" // HTTP 响应头字段，表示 JavaScript 的源映射 HeaderUpgrade = "Upgrade" // HTTP 请求/响应头字段，表示协议升级 HeaderXDNSPrefetchControl = "X-DNS-Prefetch-Control" // HTTP 响应头字段，控制 DNS 预获取行为 HeaderXPingback = "X-Pingback" // HTTP 响应头字段，表示 Pingback 的 URL HeaderXRequestID = "X-Request-ID" // HTTP 请求/响应头字段，表示请求的唯一标识符 HeaderXRequestedWith = "X-Requested-With" // HTTP 请求头字段，指示请求是由 Ajax 发起的 HeaderXRobotsTag = "X-Robots-Tag" // HTTP 响应头字段，控制搜索引擎抓取行为 HeaderXUACompatible = "X-UA-Compatible" // HTTP 响应头字段，指定浏览器的兼容性模式 )
定义常见的 HTTP 头部常量
View Source
const ( MethodGet = "GET" // RFC 7231, 4.3.1 GET 方法，用于请求指定资源的信息 MethodHead = "HEAD" // RFC 7231, 4.3.2 HEAD 方法，与 GET 方法相同，但不返回主体部分 MethodPost = "POST" // RFC 7231, 4.3.3 POST 方法，用于向指定资源提交数据 MethodPut = "PUT" // RFC 7231, 4.3.4 PUT 方法，用于向指定资源上传数据 MethodPatch = "PATCH" // RFC 5789 PATCH 方法，用于对指定资源进行部分修改 MethodDelete = "DELETE" // RFC 7231, 4.3.5 DELETE 方法，用于删除指定资源 MethodConnect = "CONNECT" // RFC 7231, 4.3.6 CONNECT 方法，用于建立到目标资源的隧道 MethodOptions = "OPTIONS" // RFC 7231, 4.3.7 OPTIONS 方法，用于获取当前 URL 所支持的方法 MethodTrace = "TRACE" // RFC 7231, 4.3.8 TRACE 方法，用于回显服务器收到的请求，主要用于测试或诊断 MethodUse = "USE" // 自定义方法，用于中间件等操作的注册 )
定义 HTTP 方法的常量
View Source
const ( StatusContinue = 100 // RFC 7231, 6.2.1：继续。客户端应继续其请求。 StatusSwitchingProtocols = 101 // RFC 7231, 6.2.2：切换协议。服务器将切换到请求的协议。 StatusProcessing = 102 // RFC 2518, 10.1：处理。请求已被接受，正在处理，但未完成。 StatusEarlyHints = 103 // RFC 8297：早期提示。允许用户代理在最终响应之前开始预加载资源。 StatusOK = 200 // RFC 7231, 6.3.1：成功。请求已成功。 StatusCreated = 201 // RFC 7231, 6.3.2：已创建。请求已成功并创建了新资源。 StatusAccepted = 202 // RFC 7231, 6.3.3：已接受。请求已被接受用于处理，但尚未完成。 StatusNonAuthoritativeInformation = 203 // RFC 7231, 6.3.4：非权威信息。请求已成功，但返回的元信息来自缓存。 StatusNoContent = 204 // RFC 7231, 6.3.5：无内容。服务器成功处理了请求，但没有返回任何内容。 StatusResetContent = 205 // RFC 7231, 6.3.6：重置内容。服务器成功处理了请求，用户代理应重置文档视图。 StatusPartialContent = 206 // RFC 7233, 4.1：部分内容。服务器成功处理了部分 GET 请求。 StatusMultiStatus = 207 // RFC 4918, 11.1：多状态。服务器返回多个资源的状态。 StatusAlreadyReported = 208 // RFC 5842, 7.1：已报告。DAV 锁定的成员资源的状态已被报告。 StatusIMUsed = 226 // RFC 3229, 10.4.1：IM 已使用。服务器已成功响应请求，并应用了 IM 变换。 StatusMultipleChoices = 300 // RFC 7231, 6.4.1：多种选择。请求有多种可供选择的响应。 StatusMovedPermanently = 301 // RFC 7231, 6.4.2：永久移动。请求的资源已永久移动到新位置。 StatusFound = 302 // RFC 7231, 6.4.3：找到。请求的资源暂时移动到新位置。 StatusSeeOther = 303 // RFC 7231, 6.4.4：查看其他位置。请求应使用另一个 URI 获取资源。 StatusNotModified = 304 // RFC 7232, 4.1：未修改。请求的资源未修改。 StatusUseProxy = 305 // RFC 7231, 6.4.5：使用代理。请求的资源必须通过代理访问。 StatusTemporaryRedirect = 307 // RFC 7231, 6.4.7：临时重定向。请求的资源暂时移动到新位置。 StatusPermanentRedirect = 308 // RFC 7538, 3：永久重定向。请求的资源已永久移动到新位置。 StatusBadRequest = 400 // RFC 7231, 6.5.1：错误请求。服务器无法理解请求。 StatusPaymentRequired = 402 // RFC 7231, 6.5.2：需要付款。保留将来使用。 StatusForbidden = 403 // RFC 7231, 6.5.3：禁止。服务器拒绝请求。 StatusNotFound = 404 // RFC 7231, 6.5.4：未找到。请求的资源未找到。 StatusMethodNotAllowed = 405 // RFC 7231, 6.5.5：方法不允许。请求的方法不允许。 StatusNotAcceptable = 406 // RFC 7231, 6.5.6：不可接受。请求的资源不可用。 StatusProxyAuthRequired = 407 // RFC 7235, 3.2：需要代理认证。客户端必须先认证代理。 StatusRequestTimeout = 408 // RFC 7231, 6.5.7：请求超时。服务器超时等待请求。 StatusConflict = 409 // RFC 7231, 6.5.8：冲突。请求与资源的当前状态冲突。 StatusGone = 410 // RFC 7231, 6.5.9：已删除。请求的资源已永久删除。 StatusLengthRequired = 411 // RFC 7231, 6.5.10：需要有效长度。请求中缺少内容长度头。 StatusPreconditionFailed = 412 // RFC 7232, 4.2：前提条件失败。请求头中指定的前提条件失败。 StatusRequestEntityTooLarge = 413 // RFC 7231, 6.5.11：请求实体太大。请求的实体太大。 StatusRequestURITooLong = 414 // RFC 7231, 6.5.12：请求 URI 太长。请求的 URI 太长。 StatusUnsupportedMediaType = 415 // RFC 7231, 6.5.13：不支持的媒体类型。请求的格式不受支持。 StatusRequestedRangeNotSatisfiable = 416 // RFC 7233, 4.4：请求范围不满足。请求的范围无效。 StatusExpectationFailed = 417 // RFC 7231, 6.5.14：期望失败。服务器无法满足请求头的期望。 StatusTeapot = 418 // RFC 7168, 2.3.3：我是一个茶壶。拒绝冲咖啡的请求。 StatusMisdirectedRequest = 421 // RFC 7540, 9.1.2：错误的请求。服务器无法产生响应。 StatusUnprocessableEntity = 422 // RFC 4918, 11.2：无法处理的实体。请求格式正确，但无法处理。 StatusLocked = 423 // RFC 4918, 11.3：锁定。资源被锁定。 StatusFailedDependency = 424 // RFC 4918, 11.4：依赖失败。由于之前的请求失败，无法处理。 StatusTooEarly = 425 // RFC 8470, 5.2.：过早。服务器不愿处理早期数据。 StatusUpgradeRequired = 426 // RFC 7231, 6.5.15：需要升级。客户端应切换到不同协议。 StatusPreconditionRequired = 428 // RFC 6585, 3：需要前提条件。请求头中需要前提条件。 StatusTooManyRequests = 429 // RFC 6585, 4：请求过多。用户在给定的时间内发送了过多请求。 StatusRequestHeaderFieldsTooLarge = 431 // RFC 6585, 5：请求头字段太大。请求头字段太大。 StatusInternalServerError = 500 // RFC 7231, 6.6.1：内部服务器错误。服务器遇到意外情况。 StatusNotImplemented = 501 // RFC 7231, 6.6.2：未实现。服务器不支持请求的方法。 StatusBadGateway = 502 // RFC 7231, 6.6.3：错误网关。服务器作为网关时收到了无效响应。 StatusGatewayTimeout = 504 // RFC 7231, 6.6.5：网关超时。服务器作为网关时未及时收到响应。 StatusHTTPVersionNotSupported = 505 // RFC 7231, 6.6.6：HTTP 版本不支持。服务器不支持请求的 HTTP 版本。 StatusVariantAlsoNegotiates = 506 // RFC 2295, 8.1：变体协商。服务器内部配置错误。 StatusInsufficientStorage = 507 // RFC 4918, 11.5：存储空间不足。服务器无法存储完成请求的表示。 StatusLoopDetected = 508 // RFC 5842, 7.2：循环检测。服务器检测到循环。 StatusNotExtended = 510 // RFC 2774, 7：未扩展。需要进一步扩展请求。 StatusNetworkAuthenticationRequired = 511 // RFC 6585, 6：需要网络认证。需要客户端进行网络认证。 )
定义 HTTP 状态码常量
View Source
const ( MIMETextXML = "text/xml" // XML 文本格式 MIMETextHTML = "text/html" // HTML 文本格式 MIMETextPlain = "text/plain" // 纯文本格式 MIMEApplicationXML = "application/xml" // XML 应用程序格式 MIMEApplicationJSON = "application/json" // JSON 应用程序格式 MIMEApplicationJavaScript = "application/javascript" // JavaScript 应用程序格式 MIMEApplicationForm = "application/x-www-form-urlencoded" // 表单 URL 编码格式 MIMEOctetStream = "application/octet-stream" // 二进制流数据（任意文件类型） MIMEMultipartForm = "multipart/form-data" // 多部分表单数据格式（用于文件上传） // MIMETextXMLCharsetUTF8 定义常见的带有 UTF-8 字符集的 MIME 类型常量 MIMETextXMLCharsetUTF8 = "text/xml; charset=utf-8" // XML 文本格式，UTF-8 字符集 MIMETextHTMLCharsetUTF8 = "text/html; charset=utf-8" // HTML 文本格式，UTF-8 字符集 MIMETextPlainCharsetUTF8 = "text/plain; charset=utf-8" // 纯文本格式，UTF-8 字符集 MIMEApplicationXMLCharsetUTF8 = "application/xml; charset=utf-8" // XML 应用程序格式，UTF-8 字符集 MIMEApplicationJSONCharsetUTF8 = "application/json; charset=utf-8" // JSON 应用程序格式，UTF-8 字符集 MIMEApplicationJavaScriptCharsetUTF8 = "application/javascript; charset=utf-8" // JavaScript 应用程序格式，UTF-8 字符集 )
定义常见的 MIME 类型的常量
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
This section is empty.
Source Files
Click to show internal directories.
Click to hide internal directories.