中国电信物联网开放平台API参考1.9.1更新说明

"中国电信物联网开放平台API参考1.9.1是电信公司提供的一份详细的技术文档，主要针对物联网开放平台的API接口进行说明。这份文档涵盖了从1.9.0到1.9.1的更新内容，包括设备管理、订阅管理、规则管理和文档结构的改进。" 本文档详细介绍了中国电信物联网开放平台的API接口，是开发者和系统集成者与该平台交互的重要参考。以下是关键知识点的详细说明： 1. **设备管理**： - **注册直连设备**：在API接口中新增了`deviceInfo`和`productId`请求参数，用于更全面地定义和注册设备信息，使得设备注册过程更加灵活。 - **修改设备信息**：增加了`customFields`、`imsi`、`ip`和`tags`请求参数，允许对设备的自定义字段、国际移动用户识别码、IP地址和标签进行更新，增强了设备信息管理的灵活性。 2. **订阅管理**： - 在订阅平台业务数据、批量查询订阅和批量删除订阅的接口中，`notifyType`枚举值进行了调整： - `serviceInfoChanged`被替换为`deviceCapabilitiesChanged`，这可能意味着订阅通知类型从服务信息变化转向设备能力变化的跟踪。 - `deviceModelAdded`被替换为`deviceCapabilitiesAdded`，表示现在订阅可以关注设备能力的添加情况。 - `deviceModelDeleted`被替换为`deviceCapabilitiesDeleted`，更新了设备模型删除的订阅逻辑，转而关注设备能力的删除事件。 3. **规则管理**： - 创建规则和修改规则的接口中，`conditions`和`actions`请求参数由可选变为必选，这意味着创建或修改规则时必须明确规则触发的条件和执行的动作，以确保规则的严谨性。 4. **文档结构调整**： - "网络结构"页面改名为"概述"并提升为一级节点，提供更直观的平台整体介绍。 - "兼容性说明"页面更名为"API使用声明"，强调了API的使用规定和注意事项。 - "消息推送"页面被整合到"订阅管理"下，更清晰地展示了订阅与消息推送的关系。 5. **批量处理**： - 创建批量任务接口增加了新功能，如`groupTag`参数，以及支持`DeviceLocation`、`DeviceMod`、`DeviceDel`和`DeviceLicense`等任务类型，提高了批量操作设备的能力。 - 查询指定批量任务信息的响应参数也相应地进行了扩展，增加了`groupTag`和其他任务类型，便于开发者获取更详细的任务状态。 6. **Beta接口内容**： - 文档中补充了Beta接口的内容，这表明平台可能提供了实验性质或正在测试的新功能，供开发者试用和反馈。 这些更新和改进旨在提高平台的功能性和易用性，同时保持与开发者之间的良好沟通，确保他们能有效地利用API来构建和扩展物联网应用。开发者在使用过程中，需要根据这些变更调整自己的代码和逻辑，以充分利用平台提供的新功能和服务。