AIoT通用组件服务攻略21 | 正确编写指令下发接口body

天翼物联网平台（AIoT）通用组件服务提供设备接入管理、规则引擎、消息推送、应用开发等丰富的功能。在设备接入方面，平台支持LwM2M、TCP、MQTT、HTTP等协议接入，支持非透传、透传和profile三种方式接入。

设备接入平台后，当客户需要远程控制设备的时候，可以通过平台的指令下发功能进行操作。指令下发平台支持两种方式：

✔ 通过平台控制台页面操作

✔ 通过调用平台API接口进行下发

根据设备接入方式，指令下发接口的“请求body”会略有区别。本篇文章，小编会根据不同的接入方式来教您如何编写“请求body”。

一、三种接入方式

● 非透传

又称为“物模型”，在通用组件服务中，定义物模型即定义产品的功能，构建产品中设备实体的数据模型。完成产品功能定义以后，系统会生成该产品的物模型，物模型描述的是该产品是什么、能做什么、能对外提供哪些服务。物模型是产品级功能，用户在创建产品选择“不透传”即可使用物模型功能。

● 透传

是指设备登录平台并完成认证以后，在上下行的数据传输过程中，平台只进行数据转发，不对业务数据进行解析。对于透传产品下创建的设备，仅支持数据上报及指令下发两种业务数据交互。对于透传的数据，平台会进行base64加密处理。

● profile接入

仅针对NB设备。创建LwM2M协议的产品时，上传经过电信官方认证的profile文件。平台默认将profile文件转换为物模型形式，产品服务完全按照profile文件定义。

不同的接入方式，“请求body”格式是固定的（LwM2M有profile除外），但是“content内容”却不一样。格式如下所示：

二、非透传接入时指令下发格式

LwM2M、TCP、MQTT这三种协议使用非透传方式接入时，content内容格式是一样的。

content内容格式为：

样例：

完整请求body示例：

三、透传接入时指令下发格式

LwM2M、TCP、MQTT（紧凑型二进制）这三种协议在透传方式接入，content内容格式是一样的。

content内容格式为：

样例1：

样例2：

完整请求body：

【注意】MQTT透传有两种消息格式，上面展示的是紧凑型二进制，还有一种是JSON格式。JSON格式的content内容会有所不同。MQTT透传（JSON格式），content内容如下所示。

content内容为：

样例：

完整请求body:

四、profile接入（LwM2M）时指令下发格式

NB设备使用LwM2M协议，并通过profile方式接入时，指令下发请求body格式如下所示：

command样例：

完整请求body：

天翼物联网平台（AIoT）还贴心为用户提供了API文档和“在线调试”功能，无需进行任何配置，输入相关参数就能使用。“在线调试”还支持一键生成代码，大大降低了开发难度，非常方便实用。

API官方文档链接：https://www.ctwing.cn/channel-help-api.htm?api=99

任选一个接口，点击“调试”，即可进入“在线调试”页面。

App Key和App Secret在“应用开发-应用管理”中获取。如果没有应用，可以新建一个“第三方应用”。

以上就是小编为您整理的三种接入方式的“请求body”写法，您都get到了吗？