Skip to content

获取 Token

接口说明

第三方应用通过此接口获取访问 Token,用于后续 API 调用的身份认证。Token 有效期为 3 小时,过期后需要重新获取。

业务场景:应用集成时,首先需要获取访问 Token,然后才能调用其他 API 接口。

请求

http
GET /app/token

请求参数

Body 参数

名称位置类型必选说明
appIdbodystring应用ID,在平台创建应用时获得
appSecretbodystring应用密钥,在平台创建应用时获得

请求示例

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"
  }
}

响应字段

名称类型必选说明
statusinteger响应状态:200-成功,401-需要重新授权,404-接口不存在,500-错误信息
descstring响应描述
timeinteger响应时间戳
dataobject响应数据
tokenstring访问令牌

使用 Token

获取到 Token 后,在后续所有 API 调用的请求头中携带:

javascript
headers: {
  'token': '<your_token>'
}

Token 有效期

Token 有效期为 3 小时,过期后需要重新调用此接口获取新的 Token。

OMI