新增设备
调用此接口,新增一个设备。
接口路径
/api/device/addDevice
请求方式
[POST]
请求参数
Headers:
参数名称 | 参数值 | 是否必须 |
---|---|---|
Content-Type | application/json | 是 |
Authorization | {token} | 是 |
- 其中token获取方式参考使用AccessKey计算token。
Body:
参数名称 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
pk | String | 是 | 将要添加设备的所属产品pk。 |
devId | String | 是 | 将要添加的设备ID。设备ID支持英文字母、数字、下划线、中划线、点,4~32个字符。设备ID为设备标识,必须唯一,如IMEI、MAC等。如果产品为NB-IoT设备,请用IMEI号作为设备ID。 |
name | String | 是 | 将要添加的设备的名称。 |
【示例】:
{
"pk":"fb432*************82bd8ebd",
"devId":"3********32j4",
"name":"test01"
}
返回参数
名称 | 类型 | 是否必须 | 说明 |
---|---|---|---|
name | String | 否 | 设备名称 |
createdDate | number | 否 | 创建时间(ms) |
updatedDate | number | 否 | 更新时间(ms) |
enable | boolean | 否 | 是否可用 |
pk | String | 否 | 所属产品pk |
devId | String | 否 | 设备devId |
online | boolean | 否 | 在线状态 |
devSecret | String | 否 | 设备密钥 |
loginTime | number | 否 | 最近一次登录时间(ms) |
logoutTime | number | 否 | 最后一次登出时间(ms) |
registerTime | number | 否 | 注册时间(ms) |
firstLoginTime | number | 否 | 上电激活时间(ms) |
deviceType | String | 否 | 设备类型 |
ipInfo | object | 否 | IP信息 |
moduleVersion | String | 否 | 模组固件版本 |
mcuVersion | String | 否 | mcu固件版本 |
configVersion | String | 否 | 远程配置版本 |
batchName | String | 否 | 批次名称 |
imei | String | 否 | 设备imei |
【示例】:
{
"name": "test01",
"createdDate": 1575655647001,
"updatedDate": 1575655647001,
"enable": true,
"pk": "fb432*************82bd8ebd",
"devId": "3********32j4",
"online": false,
"devSecret": "dcdaa***********************cd5",
"loginTime": null,
"logoutTime": null,
"registerTime": 1575655647000,
"firstLoginTime": null,
"deviceType": "GENERAL",
"ipInfo": null,
"moduleVersion": null,
"mcuVersion": null,
"configVersion": null,
"batchName": null,
"imei": null
}