远程抓图

POST

https://api2.hik-cloud.com/api/v1/open/basic/channels/actions/capture

功能描述

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

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

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/open/basic/channels/actions/capture' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{

             
        "deviceSerial": "D20591677",

             
        "channelNo": 1

             
    }'

响应示例

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

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

deviceSerial

string

设备序列号

必需

channelNo

integer

通道号

必需

示例

返回响应

🟢200成功

application/json

Body

code

string

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

picUrl

string

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

必需

修改于 2022-05-20 08:31:51

取流认证

门禁对接指南