Send Downlink Thing Model Property Data

API Address:/v2/deviceshadow/r3/openapi/dm/writeData

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

API Description: data format:

[{"key1":"value"},{"key2":"value"}]

Examples:

Properties

• bool/int/float/double/enum/date/text

[{"key":"value"}]

• array (id is 0)

[{"key":[{"0":"value1"},{"0":"value2"}]}]

• struct

[{"key":[{"key1":"value1"},{"key2":"value2"}]}]

• array containing struct (id is 0)

[{"key":[{"0":[{"key1":"value1"}]},{"0":[{"key2":"value2"}]}]}]

Service Calls

• bool/int/float/double/enum/date/text

[{"key":[{"key1":"value1"},{"key2":"value2"},{"key3":"value3"}]}]

• array (id is 0)

[{"key":[{"key1":[{"0":"value1"},{"0":"value1"}]}]}]

• struct

[{"key":[{"key1":[{"key2":"value2"},{"key3":"value3"}]}]}]

• array containing struct (id is 0)

[{"key":[{"key1":[{"0":[{"key2":"value2"}]},{"0":[{"key3":"value3"}]}]}]}]

Request Example:

{
  "cacheTime": 0,
  "data": "",
  "devices": [],
  "extendPara": {},
  "isCache": true,
  "isCover": true,
  "productKey": "",
  "qos": 0
}

Request Parameters:

Parameter Name	Parameter Description	Request Type	Required	Data Type	Schema
readDataDTOR3	readDataDTOR3	body	true	OpenApiSendTslDataDTO	OpenApiSendTslDataDTO
cacheTime	Cache time in seconds. Effective when isCache is true, default value 600.		false	integer(int64)
data	Specific content of the downlink data being sent		true	string
devices	Device list		true	array	string
extendPara			false	object
isCache	Whether to enable caching, default is false if not provided		false	boolean
isCover	Whether to overwrite previously sent data, default is false if not provided		false	boolean
productKey	Product productKey		true	string
qos	QoS level setting (default is 1 if not provided)		false	integer(int32)
language	Language: CN/EN (default: CN)	query	false	string

Response Status:

Status Code	Description	Schema
200	OK	ActionResult
201	Created
401	Unauthorized
403	Forbidden
404	Not Found
50000	Service exception
50005	Parameter check error
50007	The deviceID, productKey or deviceKey is empty
61001	PROTOCOL_NOT_SUPPORT
61002	Device offline
61005	Unauthorized device
61006	Device message upper limit
61007	Device message frequency is limited
70000	Hub service unavailable
70026	The sub-device is not connected to the gateway device
70051	Failed data sending
70083	Product category and parameter type are unmatched
70089	You have limited permission to operate this project or product or device
70090	The number is out of range or step size
70091	The value is not a member of the enumeration
70092	The text is too long
70093	Incorrect time stamp character
70094	The TSL model is unable to analyze and identify data
70095	Failed to call cloudBridgeService
70096	Failed to issue command from DMP to AEP
71008	TSL data format verification error
71027	TSL model downlink data format is not JSON
71028	TSL model downlink data format verification error
71029	Illegal downlink data setting for TSL model
71035	Parameter verification error
71036	TSL model data verification error
71038	Failed communication. Read-only attributes can't send commands
71039	The length of message array has exceeded the defined size
71047	Downstream TSL data format check error
71048	The fetch instruction cannot only contain write-only data
80005	OpenAPI does not support setting AEP products
91001	Token does not exist
91004	Token incorrect
91005	Doesn't have permission
91006	User not in IP white list
91007	Please enable API permission

Response Parameters:

Parameter Name	Parameter Description	Type	Schema
code	Return code	object
data	Object	object
exp1		string
msg	Prompt message	object
pageNum	Current page number	object
pageSize	Items per page	object
pages	Total pages	object
total	Total count	object

Response Example:

{
	"code": {},
	"data": {},
	"exp1": "",
	"msg": {},
	"pageNum": {},
	"pageSize": {},
	"pages": {},
	"total": {}
}