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

查询设备详情

请求方式:GET

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

说明:device_id的值需要替换为设备ID。

我只想看示例!!!

返回参数

参数名称格式说明
errnoint调用错误码,为0表示调用成功
errorstring 错误描述,为"succ"表示调用成功
data json接口调用成功之后返回的设备相关信息,见data描述表
data描述表
参数名称格式说明
idstring平台分配的唯一ID
onlinebool表示LwM2M设备是否在线
protocolstring设备接入协议(LwM2M)
titlestring设备名称
descstring设备描述
create_timestring设备创建时间,北京时间
obsvbool是否自动订阅
privatebool设备私密性
binaryjson设备关联的图像或者二进制数据,详情见binary描述表
tagsarray-string设备标签
observ_statusbool订阅状态,表示:设备上线后,平台下发订阅命令,设备资源是否全部成功
locationjson设备位置坐标信息,以经纬度键值对表示:{"lon":xx,"lat":xx}
auth_infostring设备鉴权信息,对应设备注册接口中的"sn"或者"mac"参数
otherjson其他设备自定义信息,以键值对格式表示,见示例
datastreamsarray-json设备数据流信息的json数组,见datastreams描述表
binary描述表
参数名称格式说明
indexstring 二进制数据索引
atstring 上传时间
sizeint 字节
descstring 描述
datastreams描述表
参数名称格式说明
idstring 数据流名称
create_time string 数据流创建时间,北京时间
unitstring 单位
unit_symbolstring 单位符号

请求示例

GET http://api.heclouds.com/devices/35****92 HTTP/1.1  //35****92为平台随机分配的设备ID
api-key: WhI*************v1c= //必须为 MasterKey, 由于涉及个人隐私,这里用“*******” 代替

返回示例

{
    "errno": 0,
    "data": { //设备信息
        "private": false, 
        "create_time": "2019-04-24 14:54:29", //设备创建时间
        "act_time": "Fri May 10 01:32:48 CST 2019",
        "obsv": true, //NB CoAP协议设备才有该字段值
        "ack": false,
        "auth_info": {
            "188xxxxxxxx": "1xxxxxx4"
        },
        "imsi": "188832xxxx234",
        "last_ct": "Fri Jun 21 17:06:32 CST 2019",
        "title": "11",
        "tags": [],
        "obsv_st": false,
        "protocol": "LwM2M",
        "rg_id": "188832963901234",
        "imsi_old": [
            "188832963901234"
        ],
        "imsi_mt": "Fri May 10 01:32:48 CST 2019",
        "online": false,
        "location": {
            "lat": 0,
            "lon": 0
        },
        "id": "524166559",
        "datastreams":  //数据流
         [   
            {
                "create_time": "2019-05-10 01:32:51",
                "uuid": "d2fd9428-45f3-45f9-bd17-7106432f22dd",
                "id": "9999_0_7"
            },
                   ],  //end data_streams
        "desc": ""
    }, //end data
    "error": "succ"
}

< 更新设备信息

批量查询设备信息 >

个搜索结果,搜索内容 “

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