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

Batch query of device information

Request format: GET

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

I only want to see examples！！！

Url parameter

Parameter Name	Format	Required?	Description
key_words	string	No	Match the key word from the left of id and title field.
auth_info	string	No	Authentication information
tag	array-string	No	Device tag
online	bool	No	Device online status
private	bool	No	Device privacy
page	int	No	Specify the page number, max. 10000
per_page	int	No	Specify the number of output devices on each page, by default 30, maximum 100
device_id	string	No	Specify the device ID, separated by commas, max. 100
begin	string	No	Beginning time, Beijing time. Example: 10/1/2019
end	string	No	End time, Beijing time. Example:10/1/2019

Return Parameters

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
total_count	int	Number of devices in the query result
page	int	Current page number
per_page	int	Number of devices per page
devices	array-json	Json data array of the device information; see devices description list.

Device Description Table

Name	Format	Description
protocol	string	Device access protocol
create_time	string	Device creation time, Beijing time
online	bool	Device online status
id	string	Device ID
auth_info	string	Device authorization information, corresponding to “sn” or “mac” parameter in the device registration interface
title	string	Device name
desc	string	Device description
tags	array-string	Device tag
location	json	Device location coordinate, represented by latitude and longitude key-value {“lon” xx “lat” xx}
other	json	Other custom information of the device, in the key-value pair format. See the example.

Request Example 1

Query the online device created from 2017-02-04 to 2017-06-04 with the tag being china.

GET http://api.heclouds.com/devices?begin=2017-02-04&end=2017-06-04&online=true&tag=china HTTP/1.1

Request Example 2

Query two devices with the device ID being 35282992 and 35271941.

GET http://api.heclouds.com/devices?device_id=35282992,35271941 HTTP/1.1

Request Example 3

Query all devices under this product

GET http://api.heclouds.com/devices HTTP/1.1

Return Example

{
    "errno": 0,
    "data": {
        "per_page": 30,
        "devices": [{
            "protocol": "EDP",
            "other": {
                "version": "1.0.0",
                "manufacturer": "china mobile"
            },
            "create_time": "2018-06-04 17:43:11",
            "online": true,
            "location": {
                "lat": 23.54,
                "lon": 109
            },
            "id": "35282992",
            "auth_info": "tes01235n82105",
            "title": "test_device",
            "desc": "test_desc",
            "tags": ["china", "mobile"]
        }, {
            "protocol": "EDP",
            "create_time": "2018-06-04 11:15:38",
            "online": true,
            "id": "35271941",
            "auth_info": "tes810372105",
            "title": "test_device",
            "tags": ["china"]
        }],
        "total_count": 2,
        "page": 1
    },
    "error": "succ"
}

< query device details

query device condition in batch>

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

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