设备消息上报

接口说明

用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。

URI

请求方法	POST
URI	/v5/devices/{device_id}/sys/messages/up
传输协议	HTTPS

请求参数

名称	必选	类型	位置	说明
access_token	是	String	Header	参数解释: 调用设备鉴权信息返回的access_token。取值范围: 长度1-256。
device_id	是	String	Path	参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。取值范围: 长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

名称

必选

类型

位置

说明

access_token

是

String

Header

参数解释:

调用设备鉴权信息返回的access_token。

取值范围:

长度1-256。

device_id

是

String

Path

参数解释:

设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。

取值范围:

长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

该接口支持设备将自定义数据通过请求中的body体上报给平台，平台收到该请求后会将body内容转发给应用服务器或华为云其他云服务上进行存储和处理。平台对body中的内容无具体格式限制，小于1MB的数据可以通过该接口携带。

请求示例

POST https://{endpoint}/v5/devices/{device_id}/sys/messages/up
Content-Type: application/json
access_token: ******
{
  "name" : "name",
  "id" : "id",
  "content" : "messageUp"
}

响应示例

Status Code: 200 ok

错误码

HTTP状态码	HTTP状态码描述	错误码	错误码描述	错误码中文描述
400	Bad Request	IOTDA.000006	Invalid input data.	请求参数不合法
403	Forbidden	IOTDA.000004	Invalid access token.	非法token
		IOTDA.021101	Request reached the maximum rate limit.	请求已经达到限制速率
		IOTDA.021102	The request rate has reached the upper limit of the tenant, limit %s.	请求已经达到租户的限制速率