// Package httpadapter HTTP 上游通道适配器(Day 33):调用上游短信 API, // 支持 GET/POST 与可配置鉴权(none/appkey/sign-HMAC),统一解析 JSON 响应。 package httpadapter import ( "bytes" "context" "crypto/hmac" "crypto/sha256" "encoding/hex" "encoding/json" "errors" "fmt" "io" "net/http" "net/url" "strconv" "strings" "time" ) // AuthType 鉴权方式。 type AuthType string // 支持的鉴权方式。 const ( AuthNone AuthType = "none" // 无鉴权 AuthAppKey AuthType = "appkey" // 请求头 X-App-Key AuthSign AuthType = "sign" // X-Timestamp + X-Sign(HMAC-SHA256(secret, ts+"."+payload)) ) // ErrBadUpstream 上游响应不合法/失败。 var ErrBadUpstream = errors.New("httpadapter: 上游返回失败") // Config 适配器配置。 type Config struct { Endpoint string // 上游地址(完整 URL) Method string // GET / POST(默认 POST) AuthType AuthType // 鉴权方式(默认 none) AppKey string // appkey 模式的 key Secret string // sign 模式的密钥 Timeout time.Duration // 默认 5s Client *http.Client // 测试注入;默认复用包级客户端 } // sharedCli 包级客户端(连接复用)。 var sharedCli = &http.Client{Timeout: 5 * time.Second} // Adapter HTTP 通道适配器。 type Adapter struct{ cfg Config } // New 构造(补默认值)。 func New(cfg Config) *Adapter { if cfg.Method == "" { cfg.Method = http.MethodPost } cfg.Method = strings.ToUpper(cfg.Method) if cfg.AuthType == "" { cfg.AuthType = AuthNone } if cfg.Timeout <= 0 { cfg.Timeout = 5 * time.Second } if cfg.Client == nil { cfg.Client = sharedCli } return &Adapter{cfg: cfg} } // SendReq 发送请求。 type SendReq struct { Mobile string `json:"mobile"` Content string `json:"content"` SrcID string `json:"src_id,omitempty"` // 扩展码/长号码 TaskID string `json:"task_id,omitempty"` // 幂等/关联任务 } // SendResp 发送响应。 type SendResp struct { MessageID string // 上游消息 ID Raw string // 原始响应体(诊断) } // upResp 上游统一响应契约:{code, msg, data:{message_id}}。 type upResp struct { Code int `json:"code"` Msg string `json:"msg"` Data struct { MessageID string `json:"message_id"` } `json:"data"` } // Send 调用上游:GET(query)/POST(JSON body);按 AuthType 注入鉴权头。 // 验收:成功调用上游发送接口并解析返回值(message_id)。 func (a *Adapter) Send(ctx context.Context, req *SendReq) (*SendResp, error) { var ( httpReq *http.Request payload []byte // 参与签名的载荷 err error ) switch a.cfg.Method { case http.MethodGet: q := url.Values{} q.Set("mobile", req.Mobile) q.Set("content", req.Content) if req.SrcID != "" { q.Set("src_id", req.SrcID) } if req.TaskID != "" { q.Set("task_id", req.TaskID) } payload = []byte(q.Encode()) httpReq, err = http.NewRequestWithContext(ctx, http.MethodGet, a.cfg.Endpoint+"?"+q.Encode(), nil) default: // POST(JSON) payload, err = json.Marshal(req) if err != nil { return nil, err } httpReq, err = http.NewRequestWithContext(ctx, http.MethodPost, a.cfg.Endpoint, bytes.NewReader(payload)) } if err != nil { return nil, err } if err := a.applyAuth(httpReq, payload); err != nil { return nil, err } if httpReq.Body != nil || a.cfg.Method == http.MethodPost { httpReq.Header.Set("Content-Type", "application/json") } resp, err := a.cfg.Client.Do(httpReq) if err != nil { return nil, fmt.Errorf("httpadapter: 请求上游失败: %w", err) } defer func() { _ = resp.Body.Close() }() raw, _ := io.ReadAll(io.LimitReader(resp.Body, 4<<10)) if resp.StatusCode < 200 || resp.StatusCode >= 300 { return nil, fmt.Errorf("%w: HTTP %d: %s", ErrBadUpstream, resp.StatusCode, string(raw)) } var up upResp if err := json.Unmarshal(raw, &up); err != nil { return nil, fmt.Errorf("httpadapter: 上游响应解析失败: %w", err) } if up.Code != 0 { return nil, fmt.Errorf("%w: code=%d msg=%s", ErrBadUpstream, up.Code, up.Msg) } return &SendResp{MessageID: up.Data.MessageID, Raw: string(raw)}, nil } // applyAuth 注入鉴权头(appkey/sign)。 func (a *Adapter) applyAuth(req *http.Request, payload []byte) error { switch a.cfg.AuthType { case AuthAppKey: req.Header.Set("X-App-Key", a.cfg.AppKey) case AuthSign: ts := strconv.FormatInt(time.Now().Unix(), 10) mac := hmac.New(sha256.New, []byte(a.cfg.Secret)) mac.Write([]byte(ts + "." + string(payload))) req.Header.Set("X-Timestamp", ts) req.Header.Set("X-Sign", hex.EncodeToString(mac.Sum(nil))) } return nil }