NB-IoT物联网套件 产品介绍 快速入门 用户指南 设备开发指南 应用开发指南 NB设备远程升级 最佳实践 常见问题 服务协议 更新日志 接入地址列表

新增设备

请求方式:POST

URL: http(s)://api.heclouds.com/devices

我只想看示例!!!

http body 请求参数

参数名称格式是否必须说明
titlestring设备名称
descstring设备描述
tagsarray-string设备标签,字符串数组
protocolstring接入协议,这里只能是LwM2M
locationjson设备位置(“纬度”,“经度”,“高度”)
privatebool设备私密性(默认true)
auth_infojsonNBIOT设备:{“imei码”:“imsi码”},imei、imsi规则见说明
authstringAuth_Code,由数字或字母组成,不超过16位
obsvbool是否订阅设备资源(默认为true)
otherjson其他信息(JSON格式,可自定义)
chipint测试设备与芯片类型对应关系(取值1-6),详情见说明
pskstringDTLS加密所使用的PSK,长度8-16个字节,字母或数字组成

返回参数

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

说明

分类IMEIIMSIchip备注
正式设备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=   //必须为 MasterKey,由于涉及个人隐私,这里用“*******” 代替
Content-Type: application/json

http请求参数示例

{
    "title": "mydevice", //设备名称
    "desc": "some description", //设备描述(可选)
    "tags": ["china", "mobile"], //设备标签(可选, 可为一个或多个)
    "protocol": "LwM2M", //接入协议
    "location": {"lon": 106, "lat": 29, "ele": 370}, //设备位置{"纬度", "精度", "高度"}(可选)
    "private": true, //设备私密性(可选, 默认为 ture)
    "auth_info": {"xxxxxxxxxxxx": "xxxxxxxxxxx"}, //NBIOT设备:{"imei" :"imsi"},imei(必须为15位)和imsi(不超过15位)都由数字组成,且首位不能为0
    "auth":"1233311",
    "obsv": true, //是否订阅设备资源,默认为true
    "other": {"version": "1.0.0", "manu": "china mobile"}, //其他信息(可选,JSON格式,可自定义)
    "chip":1, //参考chip值对应表
    "psk":"dafdfdsafd" 
}

返回示例

{
    "errno": 0, //无错误
    "data": {
        "device_id": "23444", //平台分配唯一ID
        "psk":"23ddafd3444"
    },
    "error": "succ"
}

⋙⋙⋙⋙⋙

说明:

(1) 响应消息中errno表示错误码,error表示错误原因,如果创建设备失败,则没有device_id字段;

(2) NB CoAP设备auth_info中imei(15位数字)和imsi(不超过15位数字,不为空)均由数字组成。

获取资源列表 >

个搜索结果,搜索内容 “

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