OneNET物联网平台 平台介绍 入门手册 设备开发指南 应用开发指南
API
API使用 API列表 API返回码说明 SDK MQTT LwM2M EDP Modbus TCP
消息队列MQ HTTP推送
服务定价 扩展服务 常见问题 发布公告

创建设备

请求方式:POST

URL: http://api.heclouds.com/devices

http body 请求参数

参数名称 格式 是否必须 说明
title string 设备名称
desc string 设备描述
tags array-string 设备标签,字符串数组
protocol string 接入协议,这里只能是LWM2M
location json 设备位置(“纬度”,“精度”,“高度”)
private bool 设备私密性(默认true)
auth_info json NBIOT设备:{“imei码”:“imsi码”},imei、imsi规则见说明
auth string Auth_Code,由数字或字母组成,不超过16位
obsv bool 是否订阅设备资源(默认为true)
other json 其他信息(JSON格式,可自定义)
chip int 测试设备与芯片类型对应关系(取值1-6),详情见说明
psk string DTLS加密所使用的PSK,长度8-16个字节,字母或数字组成

返回参数

参数名称 格式 说明
errno int 调用错误码,为0表示调用成功
error string 错误描述,为"succ"表示调用成功
data json 接口调用成功之后返回的设备相关信息,见data描述表
data描述表
参数名称 格式 说明
device_id string 平台分配唯一ID
psk string 在NB协议开启DTLS加密功能时返回该字段,其他情况没有该字段

说明

分类 IMEI IMSI chip 备注
正式设备 15位数字 不超过15位数字,不为空 正式设备无需chip值
测试设备 4位数字 不超过15位数字,不为空 取值1-6 测试设备必须填写chip值
chip值对应表
chip取值 1 2 3 4 5 6
芯片名称 MTK 华为120 华为150 高通 中兴微 RDA

请求示例

POST http://api.heclouds.com/devices HTTP/1.1
api-key: WhI*************v1c=
Content-Type: application/json
Host: api.heclouds.com

http请求参数示例

{
    "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,
    "psk":"dafdfdsafd" 
}

返回示例

{
    "errno": 0,
    "data": {
        "device_id": "23444",
        "psk":"23ddafd3444"
    },
    "error": "succ"
}

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “