MQTT IoT Suite Product Introduction

Profile Architecture Advantages Definitions

QuickStart

Account and Login

Products and Devices

Create Product Create Device

Device Connection

User Guide

Data Stream and Data Point Protocol Adaptation Service

Service Introduction Operation Process Development Guide Examples

Device Image

Service Introduction Console Usage

Rule Engine

Service Introduction Rule Configuration Basic Data Format SQL Built-in Function

Security Authentication

Overview Token Algorithm Token Generator Algorithm Examples

java python

Application Management

Service Introduction Controls Introduction Operating Instructions

Device Development Guide

Protocol Specifications Development Guide Development Examples Topic Cluster

Overview Data Point Topic Cluster Device Command Topic Cluster Device Image Topic Cluster

Application Development Guide

Use of API Error Code API

Query Device Register Device Remove Device Update Device Key Device Command Query Device Image Update Device Image Query Device Data Points

Best Practices

Device Connection Upload Data Points Device Synchronization Command Device Image

Change Log

Query device data point

Request Syntax

GET /devices/{device_id}/datapoints?datastream_id=ds&start=2017-01-01T00:00:00&limit=100
Authorization:xxxx

URL Parameters

Name	Format	Required or not	Description
datastream_id	string	No	Data stream ID. Multiple IDs are separated by commas. By default, the query is looking for all data streams.
start	string	No	Start time for extracting data points, measured in seconds, e.g.: 2015－01－10T08:00:35
end	string	No	End time for extracting data points, measured in seconds, e.g.: 2015－01－10T08:00:35
duration	int	No	Query time interval, in seconds
limit	int	No	Limit on the maximum number of data points returned from this request, 100 by default and in the range of (0,6000]
cursor	string	No	Specify continuous data extraction from cursor position for this request
sort	enum	No	Sort by time. DESC: in descending order, ASC: in ascending order. By default, sort by ASC.

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-related information returned after interface is successfully called. See the Data Description Table.

Data Description Table

Name	Format	Description
count	string	Number of data points returned by this request
cursor	string	If all data points cannot be returned by this request, the cursor parameter will be returned, and the user can once again request access to the remaining data points along with the cursor parameter.
datastreams	array－ json	Device data stream information in json array. See the Datastreams Description Table.

Datastreams Description Table

Name	Format	Description
id	string	Data stream name
datapoints	array－json	Data point information in json array. See the Datapoints Description Table.

Datapoints Description Table

Name	Format	Description
at	string	Data recorded time
value	string/int/json...	Data point value

Request Example 1

Request the 1st to 100th points of data stream ds of Device 8029377 since 2017-01-01T00:00:00

GET http://api.heclouds.com/devices/8029377/datapoints?datastream_id=ds&start=2017-01-01T00:00:00&limit=100 HTTP/1.1

Return Example 1

{
    "errno": 0,
    "data": {
        "cursor": "83900_8029377_1498708525203",
        "count": 100,
        "datastreams": [{
            "datapoints": [{
                "at": "2017-06-23 11:09:46.281",
                "value": "112312"
            }, {
                "at": "2017-06-23 11:09:58.799",
                "value": "112312"
            }, {
                "at": "2017-06-23 11:09:58.802",
                "value": "1213"
            }, {
                "at": "2017-06-23 11:10:17.962",
                "value": "1"
            }, 
            ...
            {
                "at": "2017-06-29 11:55:20.198",
                "value": "hello"
            }],
            "id": "ds"
        }]
    },
    "error": "succ"
}

In this example, only the first 100 data points since 2017-01-01T00:00:00 are returned. In order to continue to receive subsequent data points, you should request to

Request Example 2

get the 101st to 1100th data points since 2017-01-01T00:00:00

GET http://api.heclouds.com/devices/8029377/datapoints?datastream_id=ds&start=2017-01-01T00:00:00&limit=1000&cursor=83900_8029377_1498708525203 HTTP/1.1

Return Example 2

{
    "errno": 0,
    "data": {
        "count": 1000,
        "datastreams": [{
            "datapoints": [{
                "at": "2017-06-23 11:10:41.475",
                "value": "awefa"
            }, {
                "at": "2017-06-23 11:11:12.839",
                "value": "ad3"
            }, 
            ...
            {
                "at": "2017-06-25 11:13:54.249",
                "value": "RA414124124124"
            }, {
                "at": "2017-06-25 21:07:43.024",
                "value": "13dfadfafzfadf#123affad"
            }],
            "id": "ds"
        }]
    },
    "error": "succ"
}