获取访问令牌
使用平台分配的 appid 和 secret 换取访问令牌（token），用于后续所有业务接口的身份认证。
POST/api/getToken
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| appid | String | 平台分配的接入账号 | 必填 | - | 测试环境请联系工作人员获取 |
| secret | String | 平台分配的接入密钥 | 必填 | - | 请妥善保管，勿泄露 |
CURL
V1
curl --location --request POST 'https://open.xinduobang.cn/api/getToken' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'appid=YOUR_APPID' \
--data-urlencode 'secret=YOUR_SECRET'
V2（AppID 以 V2 开头或后台版本为 2）
V2 接入方需在请求中附加签名头，签名算法见 V2 接入示例。
curl --location --request POST 'https://open.xinduobang.cn/api/getToken' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-Timestamp: 1770000000' \
--header 'X-Nonce: 3f9c1a7b2e6d4058' \
--header 'X-Signature: <computed_hmac_sha256>' \
--data-urlencode 'appid=V2YOUR_APPID' \
--data-urlencode 'secret=YOUR_SECRET'
信息
X-Signature 需按概述页签名算法计算：待签名 body 为 appid=V2YOUR_APPID&secret=YOUR_SECRET（参数按 key 升序拼接），再与 X-Timestamp、X-Nonce 组合签名。
成功响应
{
"code": 0,
"msg": "success",
"data": {
"token": "token@@xxxxxxxx",
"expires_in": 7200
}
}
响应字段
| 名称 | 类型 | 描述 |
|---|---|---|
| code | Number | 业务状态码，0 表示成功 |
| msg | String | 状态描述 |
| data.token | String | 访问令牌，后续接口需携带 |
| data.expires_in | Number | 令牌有效期（秒），默认 7200 |
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 4001 | appid参数错误 / 非法appid参数 | 核对完整 AppID 与所属商家，不要填云应用编号 |
| 200 | 4001 | secret参数不能为空 / 参数校验失败 | 使用与该 AppID 配套的 Secret |
| 200 | 4001 | V2签名校验失败 | 核对签名头、请求参数、Secret 和时间戳，见 V2 签名说明 |
| 200 | 4003 | 接口访问频率过大，请稍后重试 | 缓存有效 Token，合并同一 AppID 的并发刷新，避免每次业务调用都换 Token |
备注
- 缓存 Token 并在过期前刷新，同一 AppID 的并发刷新应合并；不要为每个业务请求重新获取。更换 Token 不会重置商家的业务接口限额。
- 更多错误码说明见 概述 页面