获取用户北向接口认证AccessToken
功能介绍
企业管理员使用企业 AK/SK 调用此接口获取北向接口认证 AccessToken。(注意:一对AK/SK最多可同时持有两个AccessToken,且每个AccessToken有效期为七天。)
URI
POST /v2/{user_id}/enterprises/access-token
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
user_id |
是 |
String |
用户ID。 由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ak |
是 |
String |
用户认证AK。 支持大小写字母,数字,特殊字符(-_),长度范围[1,64],获取方式参考获取user ID与下载AK/SK章节。 |
|
sk |
是 |
String |
用户认证SK。 支持大小写字母,数字,特殊字符(-_),长度范围[1,64],获取方式参考获取user ID与下载AK/SK章节。 |
|
force_update |
否 |
boolean |
强制更新标识符。 AK当前仅持有 一个AccessToken 且剩余有效期小于等于两天时,可通过此参数获取新的 AccessToken 使用;其他场景传此参数不解析。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
access_token |
String |
北向接口用户认证AccessToken |
|
expire_time |
String |
剩余有效期,单位:秒 |
请求示例
POST /v2/1090***/enterprises/access-token
{
"ak":"***",
"sk":"***",
"force_update":true
}
响应示例
状态码: 200
{
"access_token": "***",
"expire_time": "168888"
}
状态码
请参见状态码
错误码
请参见错误码