InvokeThingService_物联网平台_API文档

使用说明

定义产品物模型服务时，已设置服务调用方式。因此，调用本接口时，物联网平台会根据请求参数 Identifier 值，选择服务对应的调用方式。

• 同步方式：物联网平台直接使用 RRPC 同步方式下行推送请求，设备返回 RRPC 响应消息。RRPC 使用详情，请参见什么是 RRPC。
• 异步方式：物联网平台采用异步方式下行推送请求，设备采用异步方式返回结果。订阅的 Topic 详情，请参见设备服务调用。

调用服务到设备端后，设备会返回调用结果给接口的调用方。设备端响应逻辑及响应结果，需您在设备端完成开发。设备返回结果的数据格式必须符合标准的 Alink 协议，Alink JSON 格式如下：

{
	"id": "58***89",
	"code": 200,
	"data": {},
	"message": "success",
	"localizedMsg": "localizedMsg"
}

• code 为整型数字，会返回给接口调用方，用于判断服务调用结果。
• data 为调用设备服务的结果数据，会返回给接口调用方。数据必须为 JSON 格式，由用户自行定义返回内容。
• message、localizedMsg 根据业务需要进行返回。 例如物联网平台的设备接入 C Link SDK 提供了物模型使用示例，详细内容，请参见调用服务。

使用限制

同步调用服务，最大超时时间为 8 秒。若 8 秒内服务器未收到回复，则返回超时错误。异步调用服务无最大超时时间限制。

QPS 限制

单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为 500。