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 | 表示是否调用成功。
|
示例
请求示例
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
}
文档内容是否对您有帮助?