callThingService

调用该接口调用指定设备的某项服务。

callThingService(params)

表 1. 请求参数
参数 类型 描述
params dict 请求参数对象。需包含的必需参数,请参见表params参数说明
表 2. params参数说明
参数 类型 描述
productKey String 设备所属产品的ProductKey,创建产品时,物联网平台为该产品生成的唯一标识。
deviceName String 设备的DeviceName,创建设备时生成的名称。
service String

被调用的服务identifier。

在物联网平台控制台,设备所属产品详情页的功能定义页,单击物模型 TSL,即可查看各服务的identifier。

payload String|Bytes

包含指定服务的输入参数的identifier和值。

可以通过物模型 TSL,查看服务的输入参数identifier和取值范围。

表 3. 返回值
参数 类型 描述
return dict 调用成功,则返回被调用服务的返回值;否则返回驱动上报的出错信息。

调用示例

以下示例调用设备LightDev2的turn服务。

# -*- coding: utf-8 -*-
import lecoresdk

lesdk = lecoresdk.IoTData()

def handler(event, context):
  get_params = {"productKey": "a1ZJTVs****", # Please replace it with your Product Key.
                "deviceName": "LightDev2",   # Please replace it with your Device Name.
                "service":"turn",            # The service defined in the Product TSL.
                "payload": {"LightSwitch": 1}}
  res = lesdk.callThingService(get_params)
  print(res)
  return 'OK'