API 参考

HTTPC 提供 28 个请求选项函数、5 个配置预设、8 个内置中间件和完整的下载支持。

核心架构

HTTPC 采用双层设计：Layer 1 的方法 API 是薄封装，真正处理请求的引擎是 Layer 2 的 Handler 管线。

HTTPC 双层架构
├── Layer 1  方法 API（薄封装）
│     包级函数 httpc.Get/Post/... + Client 方法 + 请求选项 → Result
│
└── Layer 2  Handler 管线（请求处理引擎）
      MiddlewareFunc(Handler) 洋葱链
      → 组装 clientImpl.middlewareChain
      → 执行（每个请求 = 组装并执行一条 Handler 链）

模块导航

核心

模块	说明
包级函数与客户端方法	Get/Post/Put/Patch/Delete 等包级函数、客户端方法和辅助函数
配置	Config 结构体、5 种预设配置、验证函数和 Cookie 安全
接口	Client、Doer、DomainClienter、RetryPolicy 等核心接口
Result	Result、RequestInfo、ResponseInfo、RequestMeta 类型和所有方法
处理器	Handler 管线、MiddlewareFunc 洋葱链、Chain 组合器与 Mutator 契约

请求与响应

模块	说明
请求选项	28 个 WithXxx 请求选项函数（请求头、请求体、认证、Cookie、回调等）
中间件	Chain 组合、8 个内置中间件工厂和审计事件类型
错误类型	ClientError、12 种 ErrorType 枚举和 12 个错误变量

高级功能

模块	说明
域名客户端	DomainClient 创建、HTTP 方法、下载方法和 URL 拼接规则
会话管理	SessionManager 的 Cookie/请求头管理和安全验证
文件下载	下载函数、DownloadConfig、断点续传和安全保护
常量与类型	BodyKind 枚举、FormData/FileData 和审计上下文键

快速参考

创建客户端

client, err := httpc.New()                    // 默认配置
client, err := httpc.New(httpc.SecureConfig()) // 安全预设
client, err := httpc.New(customConfig)         // 自定义配置

发送请求

// 包级函数
result, err := httpc.Get(url, options...)

// 客户端方法
result, err := client.Get(url, options...)

// 带上下文
result, err := client.Request(ctx, "GET", url, options...)

处理响应

result.StatusCode()           // 状态码
result.Body()                 // 响应体（字符串）
result.RawBody()              // 响应体（字节）
result.Unmarshal(&data)       // JSON 解析
result.IsSuccess()            // 是否 2xx
result.Meta.Duration          // 请求耗时
result.Meta.Attempts          // 重试次数