注册设备

POST

https://api2.hik-cloud.com/v1/devices/add

注：仅支持通过组ID管理设备，暂不支持通过组编号管理设备

功能描述

注册设备到对应分组内。注册设备时首先会将设备添加到平台，然后进行设备通道的同步。如果设备添加成功而同步通道失败，则可以获取设备列表信息，再执行同步设备下的通道接口。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/v1/devices/add' \
--header 'Authorization: Bearer ' \
--data-urlencode 'groupId=' \
--data-urlencode 'deviceSerial=' \
--data-urlencode 'validateCode='

响应示例

{
    "code": "200",
    "message": "操作成功",
    "data": {
        "deviceId": "08f02fd8903e4705a3af5be1ddc81886",
        "deviceName": "IP CAMERA1",
        "deviceModel": "DS-LR1B10GG-IS-4",
        "deviceSerial": "153129560",
        "deviceStatus": 1,
        "groupId": "3ecbc93c4a6811e6b3f1fa163ee7ae3b"
    }
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

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

groupId

string

组ID

必需

deviceSerial

string

设备序列号

必需

validateCode

string

必需

设备验证码，设备机身上的六位大写字母

返回响应

🟢200成功

application/json

Body

code

string

返回码

必需

message

string

返回消息

可选

data

object

节点对象

可选

deviceId

string

设备ID

可选

deviceName

string

设备名称

可选

deviceModel

string

设备型号

可选

deviceSerial

string

设备序列号

可选

deviceStatus

integer

设备状态 0：离线 1：在线

可选

groupId

string

所属组ID

可选

查找组的下级节点

注册设备

功能描述#

请求参数

返回响应

功能描述