InvokeThingsService

Last Updated on : 2025-10-10 06:54:14Copy for LLMView as MarkdownDownload PDF

Call this interface to call device services in batches.

Instructions for use

Currently, only asynchronous calls to this interface are supported.

Request Parameters

Name	Type	Required	Sample Values	Description
Action	String	Yes	InvokeThingsService	System defined parameters. Value: InvokeThingsService.
Args	String	Yes	{"param1":1}	To enable the input parameter information of the service, the data format is JSON String, for example Args={"param1":1} . If this parameter is empty, you need to pass in Args={} .
DeviceName.N	RepeatList	Yes	Device1	List of names of devices to invoke the service. A maximum of 100 device names are supported.
Identifier	String	Yes	Set	The identifier of the service. Service of equipment Identifier view:
ProductKey	String	Yes	A1BwAGV * * * *	The product to which the device to invoke the service belongs ProductKey .

Note: When calling an API, in addition to the API-specific request parameters described in this topic, you must also pass in the common request parameters. For more information about common request parameters, see Common parameters.

Return data

Name	Type	Sample Values	Description
Code	String	Iot.system.SystemException	The error code returned when the call fails. For more information, see Error codes.
ErrorMessage	String	System Exception	Error information returned when the call fails.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	The unique identifier generated for this request.
Success	Boolean	True	Indicates whether the call succeeded. ●True : The call was successful, but it does not mean that the called service was successfully executed. The implementation status is subject to the device log. ●False : The call failed.

Example

●Request Example

curl 'https://si-d6e8d******8958054.tuyacloud.com:8686/?Action=InvokeThingsService&Args=%7B%22param%22%3A1%7D&Identifier=testService&SignatureNonce=5c5c58171ca14baca82aeaaec49ab5bd&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&DeviceName.1=myTestDevice&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T10%3A09%3A44Z&ProductKey=k1ymv1DuLfE&Signature=VNHEXCBGqYMx0gtzvTP8oRtkDBE%3D'

●Normal Return Example

{
  "RequestId": "059C3274-6197-4BEC-95E4-49A076330E57",
  "Success": true
}

Prev DocInvokeThingService

Next DocSetDeviceProperty