获取访问令牌
使用平台分配的 appid 和 secret 换取访问令牌（token），用于后续所有业务接口的身份认证。
POST/api/getToken
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| appid | String | 平台分配的接入账号 | 必填 | - | 测试环境请联系工作人员获取 |
| secret | String | 平台分配的接入密钥 | 必填 | - | 请妥善保管，勿泄露 |
CURL
curl --location --request POST 'https://open.xinduobang.cn/api/getToken' \
--header 'Content-Type: application/json' \
--data-raw '{
"appid": "YOUR_APPID",
"secret": "YOUR_SECRET"
}'
成功响应
{
"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 | 该平台未开放接口，请联系相关客服 | 确认企业已开通开放 API 功能，appid 与 secret 是否正确 |
备注
- Token 过期前请重新获取，避免业务中断
- 更多错误码说明见 概述 页面