设备抓图

POST

https://api2.hik-cloud.com/v1/channels/{channelId}/capture

功能描述

提供设备抓拍当前画面功能。

该接口仅适用于IPC或者关联IPC的DVR设备，该接口并非预览时的截图功能。海康型号设备可能不支持萤石协议抓拍功能，使用该接口可能返回不支持或者超时。

注意：设备抓图能力有限，请勿频繁调用，频繁调用将会被拉入限制黑名单,建议调用的间隔为4s左右。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/v1/channels//capture' \
--header 'Authorization: Bearer '

响应示例

{
    "code": "200",
    "message": "操作成功",
    "data": {
        "picUrl": "http://img.ys7.com//group2/M00/C3/A7/CmGCBVjsc32Ae4ehAAIAAFvpFGc317.jpg"
    }
}

请求参数

Path 参数

channelId

string

通道ID

必需

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

返回响应

🟢200成功

application/json

Body

code

string

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

picUrl

string

抓拍图片url，图片保存有效期为2小时

必需

查询社区下设备通道列表

确权流程说明