创建设备
描述
本接口用于创建设备。所有涉及设备的API,仅适用于接入类型为“GB/T 28181”的空间。
- 接口请求域名:
qvs.qiniuapi.com
- 请求方式:POST
- 接口路径:
/v1/namespaces/{namespaceId}/devices
请求参数
路径参数
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
namespaceId | 是 | string | 空间ID |
Body
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
type | 否 | integer | 可选项为摄像头、平台两类,默认为1:摄像头,1: 摄像头, 2: 平台, 创建后不可修改 |
name | 否 | string | 设备名称(可包含 字母、数字、中划线、下划线;1 ~ 100 个字符长) |
gbId | 否 | string | 设备国标ID 要求全局唯一, 该字段为空时,会自动创建gbid |
username | 否 | string | 用户名, 4~40位,可包含大写字母、小写字母、数字、中划线。当该字段为空时,默认值就是设备国标ID |
password | 是 | string | 密码, 4~40位,可包含大写字母、小写字母、数字、中划线 |
pullIfRegister | 否 | boolean | 注册成功后启动拉流, 默认关闭 |
desc | 否 | string | 关于设备的描述信息 |
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
name | string | 设备名称 |
desc | string | 设备描述 |
nsId | string | 所属的空间ID |
nsName | string | 所属的空间名称 |
gbId | string | 设备国标ID |
state | string | 状态(offline: 离线, online: 在线, notReg: 未注册, locked: 锁定) |
username | string | 用户名 |
password | string | 密码 |
pullIfRegister | boolean | 注册成功后启动拉流, 默认关闭 |
channels | integer | 设备通道数 |
vendor | string | 厂商 |
createdAt | integer | 创建时间,Unix时间戳,秒 |
updatedAt | integer | 更新时间,Unix时间戳,秒 |
lastRegisterAt | integer | 上一次注册时间,Unix时间戳,秒 |
lastKeepaliveAt | integer | 上一次心跳时间,Unix时间戳,秒 |
示例
请求示例
curl --request POST \
--url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices \
--header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
--header 'content-type: application/json' \
--data '{
"name": "device1",
"desc": "test gb28181",
"username": "username",
"password": "password"
}'
响应示例
{
"name": "device1",
"desc": "test gb28181",
"nsId": "2akrarvzvyijd",
"nsName": "gbt",
"gbId": "31011500991320000028",
"state": "notReg",
"username": "username",
"password": "password",
"pullIfRegister": false,
"createdAt": 1596166110,
"updatedAt": 1596166110,
"channels": 0,
"lastRegisterAt": 0,
"lastKeepaliveAt": 0
}
注意
每个设备会创建一路流, 普通设备以GBId作为stramId,平台设备以平台国标ID_通道国标ID作为streamId
文档反馈
(如有产品使用问题,请提交工单)