API 参考

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

核心架构

httpc 包
├── Client 接口 - 主客户端，支持所有 HTTP 方法
├── DomainClienter 接口 - 域名作用域客户端，内置会话管理
├── Config - 配置系统（超时/连接/安全/重试/中间件）
├── RequestOption - 26 个请求选项函数
├── MiddlewareFunc - 中间件链
├── Result - 响应结果（含请求元数据）
└── 包级函数 - 无需创建客户端即可使用

模块导航

核心

模块	说明
包函数	Get/Post/Put/Patch/Delete 等包级函数、客户端方法和辅助函数
配置	Config 结构体、5 种预设配置、验证函数和 Cookie 安全
接口	Client、Doer、DomainClienter、RetryPolicy 等核心接口
Result	Result、RequestInfo、ResponseInfo、RequestMeta 类型和所有方法

请求与响应

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

高级功能

模块	说明
域名客户端	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          // 重试次数
defer httpc.ReleaseResult(result) // 释放到对象池