RRpc
向指定设备发送请求消息，并同步返回响应
服务地址：
华东2（上海）
输入参数
只看必填
IotInstanceId实例ID
ProductKey要发送消息产品的ProductKey
DeviceName要接收消息的设备名称
Timeout等待设备回复消息的时间
ContentType使用JT/T 808协议通信时
RequestBase64Byte要发送的消息内容经过Base64编码得...
Topic使用自定义的RRPC相关Topic
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

使用说明

调用该接口后，如果设备端未在设置的超时时间（Timeout）内做出反馈，即使设备收到了消息，云端也视消息为发送失败。

QPS 限制

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

说明 RAM 用户共享阿里云账号配额。

请求参数

字段名称字段详情
IotInstanceIdstring

实例 ID。您可在物联网平台控制台的实例概览页面，查看当前实例的 ID。展开详情

示例值:iot_instc_pu****_c*-v64********
ProductKeystring

要发送消息产品的 ProductKey。

示例值:aldfeSe****参考取值来源:
    CreateProduct
    QueryProductList
    ReleaseProduct
    ListProductByTags
    BindLicenseProduct
    BatchBindProductsIntoProject
DeviceNamestring

要接收消息的设备名称。

示例值:device1
Timeoutinteger<int32>

等待设备回复消息的时间，单位是毫秒，取值范围是 1,000 ~8,000。

示例值:1000
ContentTypestring

使用 JT/T 808 协议通信时，服务端向指定设备发送消息的类型。可取值：展开详情

示例值:240
RequestBase64Bytestring

要发送的消息内容经过 Base64 编码得到的字符串格式数据，例如dGhpcyBpcyBhbiBleGFtcGxl。

示例值:dGhpcyBpcyBhbiBleGFtcGxl
Topicstring

使用自定义的 RRPC 相关 Topic。需要设备端配合使用，请参见设备端开发自定义 Topic。展开详情

示例值:/a1uZfYb****/A_Vol****/user/update参考取值来源:
    SubscribeTopic
    UnsubscribeTopic
    QueryProductTopic
    CreateProductTopic

请求说明

调用 API 时，除了本文介绍的该 API 的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回参数

字段名称字段详情
MessageIdinteger<int64>

成功发送请求消息后，云端生成的消息 ID，用于标识该消息。

注意 请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。
示例值:889455942124347392
RequestIdstring

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

示例值:41C4265E-F05D-4E2E-AB09-E031F501AF7F
ErrorMessagestring

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

示例值:系统异常
Successboolean

是否调用成功。展开详情

示例值:true
Codestring

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

示例值:iot.system.SystemException
PayloadBase64Bytestring

设备返回结果 Base64 编码后的值。

示例值:d29ybGQgaGVsbG8=
RrpcCodestring

调用成功时，生成的调用返回码，标识请求状态。取值：展开详情

示例值:SUCCESS
变更历史
暂无变更历史