OneNET文档中心

新增设备

--- 请求方式:**POST** URL: http(s)://api.heclouds.com/devices #### http头部 参数名称 | 格式 | 是否必须 | 说明 :- | :- | :- | :- api-key | string | 是 | 必须为masterkey #### http请求参数 参数名称 | 格式 | 是否必须 | 说明 :- | :- | :- | :- title | string | 是 | 设备名称 desc | string | 否 | 设备描述 tags | array-string | 否 | 设备标签,可为一个或者多个,见示例 location | json | 否 | 设备位置坐标信息,以经纬度键值对表示:{"lon":xx,"lat":xx} private | bool | 否 | 设备私密性,决定应用编辑器分享链接中设备信息的可见度,默认为true auth_info | string | 否 | 鉴权信息,建议携带,并设置为设备的产品序列号 other | json | 否 | 其他设备自定义信息,以键值对格式表示,见示例 #### 返回参数 参数名称 | 格式 | 说明 :- | :- | :- errno | int | 调用错误码,为0表示调用成功 error | string | 错误描述,为"succ"表示调用成功 data | json | 接口调用成功之后返回的设备相关信息,见data描述表 ##### data描述表 参数名称 | 格式 | 说明 :- | :- | :- device_id | string | 设备ID #### 请求头部示例 ```text POST http://api.heclouds.com/devices HTTP/1.1 api-key: WhI3***************v1c= Host: api.heclouds.com ``` #### 请求参数示例 ```json { "title": "test_device", "desc": "test_desc", "tags": ["china", "mobile"], "location": { "lon": 109, "lat": 23.54 }, "auth_info": "tes01235n82105", "other": { "version": "1.0.0", "manufacturer": "china mobile" } } ``` #### 返回示例 ```json { "errno": 0, "data": { "device_id": "35270468" }, "error": "succ" } ```