thirdparty

type Client struct {
	// contains filtered or unexported fields
}

type Config struct {
	// BaseURL 第三方服务根地址(如 https://sms.partner.com)。
	BaseURL string
	// Signer 签名器(NewHMACSigner / NewRSASignerFromPEM / NewBearerSigner)。
	Signer Signer
	// Timeout 单次请求总超时;非正数时使用 DefaultTimeout。
	Timeout time.Duration
	// MaxRetries 失败重试次数(默认 2;网络错误与 5xx 重试,4xx 不重试)。
	MaxRetries int
	// RetryBaseDelay 重试基础退避(默认 200ms,指数增长 + 抖动)。
	RetryBaseDelay time.Duration
	// ExtraHeaders 附加固定请求头(如 Accept-Language)。
	ExtraHeaders map[string]string
	// NonceFunc 自定义 nonce 生成;nil 时使用 crypto/rand 随机 hex。
	NonceFunc func() (string, error)
	// Breaker 熔断器(circuit.New 创建);nil 时不启用。下游连续失败(网络错误/5xx)
	// 达到阈值后快速失败(错误码 B0200 系统容灾被触发),防止故障雪崩。
	Breaker *circuit.Breaker
}

type Signer interface {
	// Sign 计算签名;method/path 为请求方法与路径(不含 query),
	// timestamp 为 Unix 秒字符串,nonce 为随机串,bodySHA256 为请求体 SHA256 hex。
	Sign(method, path, timestamp, nonce, bodySHA256 string) (string, error)
	// HeaderName 返回签名写入的请求头名称。
	HeaderName() string
	// HeaderValue 返回签名头附带的值(如 AppKey 或 Bearer token)。
	HeaderValue() string
}