NB-IoT Suite Product Introduction

Profile Resource model Advantages Definitions

QuickStart

Products and Devices

Create Product Create Device

Device access process

User Guide

Rule Engine

Service Introduction Rule Configuration Basic Data Format SQL

Message queue Application Management

Service Introduction Controls Introduction Operating Instructions

Device Development Guide

Protocol introduction Object and attribute Development Guide Supported module list Obtaining SDK transplantation Document download

Application Development Guide

API Authentication API List Device management-related API

Add new device Obtain the resource list Update device information Query device details Query device information in batch Query device condition in batch Query device information according to IMEI Delete device

Query API at data point

Query device latest data in batch Check data point

Real-time command API

Real-time command-resource discovery Real-time command-resource observation Real-time command-read device resource Real-time command-write device resource Real-time command-command release

Cache command API

Cache command-read device resource Cache command-write device resource Cache command-command release Check the cache command list of specified device Check the details of specified cache command Cancel cache command

Trigger-related API

Add trigger Update trigger Check trigger Delete trigger

DTLS-related API

Check device bs_psk Update bs_psk Add acc_psk Edit acc_psk Check device acc_psk

API status code HTTP push

Service Introduction Service configuration Development Guide Push SDK

Best Practices

Access based on module (5310) Access based on MCU

FAQ

Registration-related issue Protocol-related issue API-related issue OTA-related issue Application development issue Other issues

Service agreement

IMEI Complaint service agreement

Query device details

Request format: GET

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

Note: device_id value needs to be replaced by device ID.

I only want to see examples！！！

Return Parameters

Parameter Name	Format	Description
errno	int	Call error code, where 0 means success.
error	string	Error description, where "succ" means success.
data	json	Device dependent message returned after the interface is successfully invoked; see Data Description Table

Data Description Table

Name	Format	Description
id	string	Unique ID assigned by the platform
online	bool	whether LwM2M device is on line
protocol	string	Device access protocol (LwM2M)
title	string	Device name
desc	string	ngDevice description
create_time	string	Device creation time, Beijing time
obsv	bool	Automatically subscribed or not
private	bool	Device privacy
binary	json	Device associate image or binary data; see binary description list for details.
tags	array-string	Device tag
observ_status	bool	Subscription status, representing: after the device is on line and the platform releases the subscription command, whether all device resources are successful
location	json	Device location coordinate, represented by latitude and longitude key-value {“lon” xx “lat” xx}
auth_info	string	Device authorization information, corresponding to “sn” or “mac” parameter in the device registration interface
other	json	Other custom information of the device, in the key-value pair format. See the example.
datastreams	array-json	Json array of data stream information of device, see Datastreams Description Table

binary description list

Name	Format	Description
index	string	Binary data index
at	string	Upload time
size	int	Byte
desc	string	s

Datastreams Description Table

Name	Format	Description
id	string	Data stream name
create_time	string	Data stream creation time, Beijing time
unit	string	Unit
unit_symbol	string	Unit symbol

Request Example

GET http://api.heclouds.com/devices/35****92 HTTP/1.1  //35****92为,Device ID randomly assigned to the platform
api-key: WhI*************v1c= //Must be MasterKey, because it involves personal privacy, use "*******" instead

Return example

{
    "errno": 0,
    "data": { //Device Information
        "private": false, 
        "create_time": "2019-04-24 14:54:29", //Device creation time
        "act_time": "Fri May 10 01:32:48 CST 2019",
        "obsv": true, //NB lwM2M protocol devices only have this field value
        "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":  //data_streams
         [   
            {
                "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"
}

< Update device information

Batch query device information >

个搜索结果，搜索内容 “”

0 个搜索结果，搜索内容 “”