检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的，在accessToken快过期时，第三方应用通过调用此接口，获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前，从物联网平台获取新的accessToken。 接口描述 1
典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的，在accessToken快过期时，第三方应用通过调用此接口，获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前，从物联网平台获取新的accessToken。 接口描述 1
第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项 鉴权接口
第三方应用若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 接口描述 1 void
第三方应用若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 接口描述 1 def
解码插件的作用就是将设备上报的“二进制”格式数据，按照Profile文件的定义的属性转换为“JSON”格式数据，便于物联网平台和应用服务器识别。同时，用户远程下发控制命令时，物联网平台会将“JSON”格式的命令转换为“二进制”格式数据下发给设备。 注：如果设备本身上报的是JSON
华为物联网平台（简称物联网平台）提供海量设备的接入和管理，配合华为云其他产品同时使用，帮助快速构筑物联网应用。 使用物联网平台构建一个完整的物联网解决方案主要包括3部分：物联网平台、业务应用和设备。 物联网平台作为连接业务应用和设备的中间层，屏蔽了各种复杂的设备接口，实现设备的快速接入；同时提供强大的开放能力，支撑行业用户快速构建各种物联网业务应用。
设备：表示满足条件的数据是由单个设备上报到平台。 设备类型：表示满足条件的数据是由选择的某一设备类型的设备上报到平台。 设备群组：表示满足条件的数据是由所选设备群组的设备上报到平台。 选择设备模型：选择满足条件后上报数据的设备的模型。选择设备模型后需要选择对应的服务类型，并设置上报数据的规则。
} encode接口说明 encode接口的入参是JSON格式的数据，是平台下发的命令或应答。 平台的下行报文可以分为两种情况： 平台对设备上报数据的应答（对应图中的消息②） 表2 平台收到设备的上报数据后对设备的应答encode接口的入参结构定义 字段名 类型 参数描述 是否必填
平台。由于不同事件的推送消息结构不同，因此应用服务器可以考虑为每一种事件实现一个Restful接口。 注意事项： 关于平台上的事件种类和推送的消息样例，请参考推送通知。 https推送的前提是先在平台上上传应用服务器的CA证书。 命令下发 本部分接口提供命令的创建、删除、查询、批量创建等功能。
services[] 设备物模型的属性定义。 表2 services结构体 参数名称 类型 描述 service_id String 设备的服务ID，在设备关联的产品模型中定义。 properties ObjectNode[] 设备按照物模型上报的具体数据。 event_time String
“MQTT地址”（“EN_IOTA_CFG_MQTT_ADDR”）一般为同一个地址，可以从绑定成功的广播中得到。一般情况下，这个地址和Agent Lite设备或网关对接的平台地址一致。 绑定成功的广播参数获取可以参考Device_RegResultHandler函数的处理。 1 2
阅后推送固件升级结果通知） callbackurl 必选 String body 订阅的回调地址，用于接收对应类型的通知消息。 必须使用HTTPS信道回调地址，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest
阅后推送固件升级结果通知） callbackurl 必选 String body 订阅的回调地址，用于接收对应类型的通知消息。 必须使用HTTPS信道回调地址，同时回调地址中必须指定回调地址的端口。例如：https://XXX.XXX.XXX.XXX:443/callbackurltest
将设备上报的二进制码流解码成JSON格式的数据，发送给应用服务器。 将应用服务器响应的JSON格式数据编码成二进制码流，下发给设备。 命令下发流程 在命令下发流程中，有两处需要用到编解码插件： 将应用服务器下发的JSON格式数据编码成二进制码流，下发给设备。 将设备响应的二进制码流
调用API接口前建议完成Profile文件和编解码插件的开发。尽管接口的调用不依赖于Profile文件和编解码插件，但是由于profile文件定义了设备数据的字段，编解码插件是上报数据和下发命令时的必要条件，因此为了使得调用接口前的业务都正常，需要先行完成产品的开发。 为充分了解接口，建议提前获取
推送通知 应用服务器向物联网平台订阅设备信息，当设备信息发生变更时，物联网平台向应用服务器推送此消息，应用服务器根据通知类型对消息分派处理。需要配合订阅管理接口使用。 注册设备通知 绑定设备通知 设备信息变化通知 设备数据变化通知 设备数据批量变化通知 设备服务能力变化通知 设备服务能力增加通知
绑定成功的广播中得到的。 “平台HTTP地址”（“LOGIN_CONFIG_IOCM_ADDR”）和“MQTT地址”（“LOGIN_CONFIG_MQTT_ADDR”）一般是同一个地址，可以从绑定成功的广播中得到。一般情况下，这个地址和Agent Lite设备或网关对接的平台地址一致。
订阅管理-V3 物联网平台支持应用服务器对设备数据的订阅，若订阅的设备信息有变更，平台会推送给应用服务器。消息订阅接口需要与推送通知接口配合使用。 订阅平台业务数据 订阅平台管理数据 查询单个订阅 批量查询订阅 删除单个订阅 批量删除订阅 推送通知 父主题： 应用侧API参考（联通用户专用）
serviceId 必选 String(1-64) body 命令对应的服务ID，要与profile中定义的serviceId保持一致。 method 必选 String(1-128) body 服务下具体的命令名称，要与profile中定义的命令名保持一致。 paras 可选 ObjectNode
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
