OneNET文档中心

创建设备

--- 请求方式:**POST** URL: http(s)://api.heclouds.com/devices #### http头部 参数名称 | 格式 | 是否必须 | 说明 :- | :- | :- | :- api-key | string | 是 | 必须为masterkey或者具备该设备访问权限的apikey Content-Type | string | 是 | 必须为application/json #### http请求参数 参数名称 | 格式 | 是否必须 | 说明 :- | :- | :- | :- title | string | 是 | 设备名称 desc | string | 否 | 设备描述 tags | array-string | 否 | 设备标签,字符串数组 protocol | string | 是 |接入协议,这里只能是LWM2M location | json | 否 | 设备位置(“纬度”,“精度”,“高度”) private | bool | 否 | 设备私密性(默认true) auth_info | json | 是 | NBIOT设备:{“imei码”:“imsi码”},imei、imsi均由15位数字组成,且首位不能为“0” auth | string | 否 | Auth_Code,由数字或字母组成,不超过16位 obsv | bool | 否 | 是否订阅设备资源(默认为true) other | json | 否 | 其他信息(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: WhI*************v1c= Content-Type: application/json Host: api.heclouds.com ``` #### http请求参数示例 ```json { "title": "mydevice", "desc": "some description", "tags": ["china", "mobile"], "protocol": "LWM2M", "location": {"lon": 106, "lat": 29, "ele": 370}, "private": true, "auth_info": {"xxxxxxxxxxxx": "xxxxxxxxxxx"}, "auth":"1233311", "obsv": true, "other": {"version": "1.0.0", "manu": "china mobile"}, "chip":1 } ``` #### 返回示例 ```json { "errno": 0, "data": { "device_id": "23444" }, "error": "succ" } ```