获取 Token
接口说明
第三方应用通过此接口获取访问 Token,用于后续 API 调用的身份认证。Token 有效期为 3 小时,过期后需要重新获取。
业务场景:应用集成时,首先需要获取访问 Token,然后才能调用其他 API 接口。
请求
http
GET /app/token请求参数
Body 参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| appId | body | string | 是 | 应用ID,在平台创建应用时获得 |
| appSecret | body | string | 是 | 应用密钥,在平台创建应用时获得 |
请求示例
bash
curl -X GET "http://182.254.182.254:9090/app/token" \
-H "Content-Type: application/json" \
-d '{
"appId": "RC_APP25090001",
"appSecret": "rBIzZ8UVJsxLqwRtAOhWpiHFjjqaTSWHe7GOSZDkp4I"
}'javascript
const response = await fetch('http://182.254.182.254:9090/app/token', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
appId: 'RC_APP25090001',
appSecret: 'rBIzZ8UVJsxLqwRtAOhWpiHFjjqaTSWHe7GOSZDkp4I'
})
});
const data = await response.json();响应
成功响应
状态码:200
json
{
"status": 200,
"desc": "string",
"time": 0,
"data": {
"token": "string"
}
}响应字段
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| status | integer | 是 | 响应状态:200-成功,401-需要重新授权,404-接口不存在,500-错误信息 |
| desc | string | 是 | 响应描述 |
| time | integer | 是 | 响应时间戳 |
| data | object | 是 | 响应数据 |
| token | string | 是 | 访问令牌 |
使用 Token
获取到 Token 后,在后续所有 API 调用的请求头中携带:
javascript
headers: {
'token': '<your_token>'
}Token 有效期
Token 有效期为 3 小时,过期后需要重新调用此接口获取新的 Token。
