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