github.com/qiniu/go-sdk/v7@v7.27.0/storagev2/http_client/doc.go (about)

     1  // Package http_client 提供 storagev2 体系的 HTTP 客户端和通用选项。
     2  //
     3  // [Options] 结构体是 storagev2 中配置 HTTP 行为的核心类型，
     4  // 被 uploader、downloader、objects 等高级模块通过嵌入方式使用。
     5  //
     6  // # Options 配置
     7  //
     8  // [Options] 包含凭证、区域、重试、拦截器等配置：
     9  //
    10  //	opts := http_client.Options{
    11  //	    Credentials:       cred,       // 认证凭证
    12  //	    Regions:           provider,   // 区域信息
    13  //	    UseInsecureProtocol: false,    // 是否使用 HTTP（默认 HTTPS）
    14  //	}
    15  //
    16  // 高级模块通常嵌入此结构体：
    17  //
    18  //	uploadManager := uploader.NewUploadManager(&uploader.UploadManagerOptions{
    19  //	    Options: http_client.Options{Credentials: cred},
    20  //	})
    21  //
    22  // # HTTP 客户端
    23  //
    24  // [Client] 封装了带重试、区域路由和认证签名的 HTTP 客户端：
    25  //
    26  //	client := http_client.NewClient(&opts)
    27  //	resp, err := client.Do(ctx, &http_client.Request{
    28  //	    Method:       "GET",
    29  //	    ServiceNames: []region.ServiceName{region.ServiceRs},
    30  //	    Path:         "/stat/...",
    31  //	    Credentials:  cred,
    32  //	    AuthType:     auth.TokenQiniu,
    33  //	})
    34  //
    35  // # 请求体构建
    36  //
    37  //   - [GetJsonRequestBody]: JSON 格式请求体
    38  //   - [GetFormRequestBody]: 表单格式请求体
    39  //   - [GetMultipartFormRequestBody]: Multipart 表单请求体
    40  package http_client