Table of Contents
2.2 通用请求头【已开发，待测试】
| Header | 必填 | 说明 |
|---|---|---|
Authorization |
登录后必填 | Bearer Token |
Content-Type |
是 | application/json 或 multipart/form-data |
X-Request-Id |
建议 | 客户端请求唯一标识 |
Idempotency-Key |
写操作必填 | 创建订单、充值、提现、兑换、退款等防重复提交 |
X-App-Version |
APP 必填 | APP 展示版本号，对应 SQL app_version_name |
X-App-Build |
APP 必填 | APP 构建号，对应 SQL app_version_code / version_code |
X-App-Channel |
APP 必填 | 渠道代码，对应 channel_code |
X-App-Market |
APP 建议必填 | 应用市场代码，对应 market_code，例如 tieup_ios、tieup_hw；无明确市场时传 * |
X-App-Platform |
APP/H5 必填 | 系统平台，传 ios / android / h5（大小写不敏感）；服务端解析为 1=iOS、2=Android、3=H5，未知或缺失回退为 0=通用且不能发起第三方支付；市场代码必须通过 X-App-Market 传递 |
X-Device-Id |
APP 建议必填 | 设备标识，用于限流、风控、日志排查 |
Idempotency-Key 建议格式：
Idempotency-Key: 业务类型_用户ID或设备ID_时间戳_随机串
示例：
Idempotency-Key: subscription_10001_20260602143000_x7f9k2
订单类业务的业务类型使用 tieup_order.business_type，例如 candy_recharge、subscription、video_call。同一次重试必须复用同一个 Idempotency-Key，重新发起业务必须生成新值。