新增设备
调用此接口,新增一个设备。
接口路径
/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
}