Updated on 2026-09-01 GMT+08:00

API Overview

Device Authentication

API

Description

Authenticating a Device

This API is used to authenticate a device. Connections can be established between devices and IoTDA after successful authentication. After the authentication is successful, IoTDA returns an access token. An access token is required when APIs for property reporting and message reporting are called. If an access token expires, you need to authenticate the device again to obtain an access token. If you obtain a new access token before the old one expires, the old access token will be valid for 30 seconds before expiration.

Device Message Reporting

API

Description

Reporting a Device Message

Used by a device to report custom data to the platform, which then forwards reported messages to an application or other services for storage and processing.

Device Reporting Properties

API

Description

Reporting Device Properties

This API is used by a device to report property data in the format defined in the product model to IoTDA.

Gateway Reporting Child Device Properties

This API is used to report device data in batches to IoTDA. A gateway can use this API to report the property data of a maximum of 50 child devices at the same time.