获取用户 Token

使用授权码换取用户级访问令牌。

接口信息

属性	值
请求方式	POST
请求路径	/v1/auth/user-token
鉴权方式	无需鉴权

请求参数

参数	类型	必填	说明
app_id	string	是	应用 ID
app_secret	string	是	应用密钥
code	string	是	授权码
grant_type	string	是	固定值 authorization_code

请求示例

curl -X POST 'https://api.im.example.com/v1/auth/user-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "cli_xxxxxx",
    "app_secret": "xxxxxx",
    "code": "abc123",
    "grant_type": "authorization_code"
  }'

响应参数

参数	类型	说明
access_token	string	用户访问令牌
refresh_token	string	刷新令牌
expires_in	number	有效期（秒）
user_id	string	用户 ID

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "access_token": "u-xxxxxx",
    "refresh_token": "r-xxxxxx",
    "expires_in": 7200,
    "user_id": "user_001"
  }
}

错误码

错误码	说明
10201	code 无效或已过期
10202	code 已被使用
10203	grant_type 错误