中国电信物联网开放平台API参考1.9.1

中国电信物联网开放平台API参考1.9.1是该平台的一个重要技术文档，主要介绍了平台对外提供的接口和服务。这个版本相较于之前的1.9.0和1.5.1进行了多项更新和优化，旨在提升平台的稳定性和用户体验。 1. 订阅管理： - 在1.9.1版本中，订阅管理接口进行了调整。原先的notifyType枚举值serviceInfoChanged被替换为deviceCapabilitiesChanged，deviceModelAdded替换为deviceCapabilitiesAdded，deviceModelDeleted替换为deviceCapabilitiesDeleted。这些更改反映了平台对设备能力变化的关注，而非仅仅是服务或模型的增删。 - 平台增加了批量查询订阅和批量删除订阅的接口，便于开发者进行大规模的数据管理和操作。 2. 规则管理： - 在创建规则和修改规则的接口中，原本作为可选参数的conditions和actions在新版本中变为必选。这表明平台强调了规则触发条件和执行动作的重要性，确保每个规则都有明确的行为定义。 3. 文档结构调整： - 为了提高用户导航体验，文档的结构进行了重大调整。“网络结构”页面改名为“概述”，并成为一级节点，使用户更容易理解平台的基本架构。 - “兼容性说明”页面更名为“API使用声明”，同样升级为一级节点，方便开发者了解API的使用规范和注意事项。 - “消息推送”页面被整合到“订阅管理”下，更加清晰地展示了订阅与消息推送的关联。 4. 批量处理： - 对于批量任务的创建和查询，增加了groupTag参数，以及DeviceLocation、DeviceMod、DeviceDel和DeviceLicense等任务类型，使得批量操作更加灵活，支持更多种类的任务场景。 - 请求参数param结构体下的type参数新增取值GroupIdList，这表明平台支持通过设备组来进行批量操作，提高了效率。 5. 其他改进： - 补充了Beta接口内容，意味着平台正在尝试引入新的功能，供开发者测试和反馈。 - 部分接口的错误码进行了修正，增强了错误处理的准确性和友好性。 6. 接口列表： - 接口列表详细列出了应用安全接入、鉴权、刷新token等相关接口，这些接口是开发者与平台交互的基础，确保了数据传输的安全和高效。 中国电信物联网开放平台API参考1.9.1版本在多个方面进行了优化，包括订阅管理、规则管理、文档结构、批量处理和接口错误处理，提升了平台的易用性和功能完整性，为开发者提供了更强大的工具和更清晰的指导。