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

获取用户北向接口认证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"
}

状态码

请参见状态码

错误码

请参见错误码

父主题： 认证管理

相关文档