设备注册
更新时间：2022-12-13
接口描述
本接口用于注册BVCP设备。
请求（Request）
请求URI
POST /v1/device?bindDeviceBySnCode
请求头域
除公共头域外，无其它特殊头域。
请求体
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| spaceId | Long | 是 | 空间ID |
| snCode | String | 是 | sn码 |
| deviceName | String | 是 | 设备名称 |
| deviceMode | String | 是 | 设备型号（可选值：TD_9555A3：同为ipc；TD_3116B2_16P：同为NVR；SDK_IPC：BVCPSDK的ipc；SDK_NVR：BVCPSDK的NVR） |
| type | String | 否 | 设备类型（可选值：BVCP、BVCPSDK，默认值BVCP） |
| description | String | 否 | 设备描述 |
| gis | Object | 否 | 设备位置信息 |
| + longitude | Float | 是 | 经度，范围[-180, 180] |
| + latitude | Float | 是 | 经度，范围[-90, 90] |
| + name | String | 是 | 地理位置名称 |
| storeId | String | 否 | 店铺ID |
| gbDeviceId | String | 否 | 国标设备ID |
| deciceIp | String | 否 | 设备IP |
| macInfo | String | 否 | 设备mac地址 |
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| deviceId | Long | 设备ID |
| snCode | String | sn码 |
示例
请求示例
Plain Text
1POST /v1/device?bindDeviceBySnCode HTTP/1.1
2x-bce-date: 2020-03-25T09:28:13Z
3host: evs.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
6{
7 "spaceId": 1000001,
8 "deviceName": "evs_device_name",
9 "snCode": "HT0018aeb870c3",
10 "deviceMode":"TD_3116B2_16P",
11 "type":"BVCP"
12}响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
4Cache-Control: no-cache
5Server: BWS
6Date: Tue, 24 Mar 202 013:34:07 GMT
7Content-Type: application/json;charset=UTF-8
8
9{
10 "deviceId": 1000001,
11 "snCode": "HT0018aeb870c3",
12}错误码
| 错误码（Code） | 消息（Message) | 描述 | HTTP状态码 |
|---|---|---|---|
| DeviceAlreadyBinded | device already binded, SN Code: XXX, device: XXX | sn码已经绑定过设备 | 400 |
| DeviceSnModeIllegal | device mode is not compatible with space, space : XXX | 设备类型不合法，与空间不一致 | 400 |