InvokeThingsService

更新时间:

InvokeThingsService

调用该接口批量调用设备服务。

使用说明

目前只支持异步调用该接口。

请求参数

名称

类型

是否必选

示例值

描述

Action

String

InvokeThingsService

系统规定参数。取值:InvokeThingsService。

Args

String

{"param1":1}

要启用服务的入参信息,数据格式为JSON String,例如Args={"param1":1}

若此参数为空时,需传入Args={}

DeviceName.N

RepeatList

device1

要调用服务的设备的名称列表。最多支持传入100个设备名称。

Identifier

String

Set

服务的标识符。

设备的服务Identifier的查看方式:

ProductKey

String

a1BwAGV****

要调用服务的设备所隶属的产品ProductKey

重要

‼️ 注意:调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数

返回数据

名称

类型

示例值

描述

Code

String

iot.system.SystemException

调用失败时,返回的错误码。更多信息,请参见错误码

ErrorMessage

String

系统异常

调用失败时,返回的出错信息。

RequestId

String

E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

为该请求生成的唯一标识符。

Success

Boolean

true

表示是否调用成功。

  • true:调用成功,但不代表调用的服务执行成功。执行情况,以设备端日志为准。

  • false:调用失败。

示例

请求示例

curl 'https://si-d6e8d812acb848958054.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'

正常返回示例

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