生成授权凭证

在调用服务端API前，需要先调用获取token接口获取access_token,通过access_token来鉴权调用者身份。

         在使用access_token时，请注意：
         access_token的有效期为604800秒（7天），有效期内重复获取返回相同结果，过期后获取会返回新的access_token。
         开发者需要缓存access_token，用于后续接口的调用。当access_token失效或过期时，接口会返回http状态码401，需要重新获取access_token。
         不能频繁调用获取access_token接口，否则会受到接口调用频率拦截。

准备工作

在获取access_token前，需要先获取应用的client_id和client_secret：
1.登录海康云眸开发者服务

2.在秘钥管理页面，查看应用的client_id和client_secret。

其中 “access_token” 字段即为请求 REST API 所需的令牌,access_token生成时有效期为7天，expires_in字段表示剩余有效时间，开发者需要对access_token的有效性进行判断，若调用API时返回Http状态码为401，则说明access_token已失效，重新获取即可。

注：在使用postman调试时，注意尽量不要使用浏览器插件版本的postman，使用客户端版本的。因为插件版本的默认会使用浏览器中的cookie和缓存，可能在调用时会出现问题而难以排查。

curl --location --request POST 'https://api2.hik-cloud.com/oauth/token' \ --header 'Authorization: Bearer ' \ --data-urlencode 'client_id=' \ --data-urlencode 'client_secret=' \ --data-urlencode 'grant_type='

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/x-www-form-urlencoded

client_id

string

必需

客户端ID（使用云眸系统管理员账号登录开放平台门户网站open2.hik-cloud.com，进入密钥管理页面查看获取）

client_secret

string

必需

访问密钥（使用云眸账号登录开放平台门户网站open2.hik-cloud.com，进入密钥管理页面查看获取）

grant_type

string

必需

认证模式（目前仅支持client_credentials）

scope

string

可选

权限范围（可选填app）

application/json

Body

access_token

string

访问令牌

必需

token_type

string

令牌类型

必需

expires_in

integer

过期时间(秒)

必需

scope

string

权限范围

可选

准备工作#

请求参数

返回响应

准备工作