文档首页> 行业视频管理服务 IVM> API参考> 认证管理> 获取用户北向接口认证AccessToken
更新时间:2024-05-22 GMT+08:00
分享

获取用户北向接口认证AccessToken

功能介绍

企业管理员使用企业 AK/SK 调用此接口获取北向接口认证 AccessToken。(注意:一对AK/SK最多可同时持有两个AccessToken,且每个AccessToken有效期为七天。)

URI

POST /v2/{user_id}/enterprises/access-token

表1 路径参数

参数

是否必选

参数类型

描述

user_id

String

用户ID。

由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

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

表3 响应Body参数

参数

参数类型

描述

access_token

String

北向接口用户认证AccessToken

expire_time

String

剩余有效期,单位:秒

请求示例

POST /v2/1090***/enterprises/access-token

{
	"ak":"***",
	"sk":"***",
	"force_update":true
}

响应示例

状态码: 200

{
  "access_token": "***",
  "expire_time": "168888"
}

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品