注册设备
更新时间：2022-05-05 10:00:16
本文介绍注册设备的 API。
接口描述
合作厂商设备注册成为涂鸦设备。
接口地址
POST: /v1.0/iot-03/3rdcloud/devices/{third_cloud_device_id}/register
请求参数
| 参数名 | 类型 | 参数位置 | 是否必填 | 说明 |
|---|---|---|---|---|
| third_cloud_device_id | String | uri | true | 合作⼚商设备唯⼀ ID，建议采⽤设备端可读取的唯⼀标识，例如设备的 SN 号、MAC 地址 、IMEI 号等，⻓度不超过 32 个字符 |
body 说明
| 参数名 | 类型 | 参数位置 | 是否必填 | 说明 |
|---|---|---|---|---|
| device_name | String | body | true | 设备名称，⻓度不超过 50 个字符 |
| product_id | String | body | true | 涂鸦产品 ID |
| options | Object | body | false | 设备扩展信息，包含：
|
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| result | Object | 响应结果 |
| code | Boolean | 参见错误码，成功为空 |
| msg | String | 请求失败的信息，成功为空 |
| success | Boolean | 请求是否成功。
|
| t | Long | 请求响应的时间戳，长度 13 位 |
result 说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| device_id | String | 涂鸦设备 ID |
请求示例
POST: /v1.0/iot-03/3rdcloud/devices/ A18007210830****/register
{
"device_name": "测试设备",
"product_id": "xz0uukkq5oce****",
"options": {
"mac": "48ea63fd****",
"installLocation": "杭州市⻄湖区蒋墩路****"
}
}
返回示例
{
"result": {
"device_id": "6cf4171005d11e2ca7****"
},
"t": 1561456817168,
"success": true
}
错误码
参考 错误码。
该内容对您有帮助吗？
是意见反馈该内容对您有帮助吗？
是意见反馈
关注“涂鸦智能”
涂鸦服务尽在掌握
关注“涂鸦开发者”
获取最新涂鸦开发者信息
