中国电信NB-IoT开发接口资料详细介绍了中国电信物联网开放平台的API(Application Programming Interface,应用程序编程接口)版本1.9.1,该文档主要针对的是中国电信物联网服务,提供设备管理、数据采集、命令下发以及设备升级等功能。以下是该文档中的关键知识点:
1. **接口概述**:
- 物联网平台通过API对外提供服务,旨在简化开发者的工作,让他们能够快速构建基于中国电信物联网平台的应用程序。
- 提供的“使用前必读”部分指导用户理解和准备使用这些API,确保他们了解调用流程和基本要求。
2. **订阅管理**:
- 在1.9.1版本中,接口参数和枚举值有所调整,如`notifyType`的变更,`serviceInfoChanged`改为了`deviceCapabilitiesChanged`,反映了对设备能力变化的关注。
- 新增了`deviceCapabilitiesAdded`和`deviceCapabilitiesDeleted`,以适应设备模型更新和删除的需求。
3. **规则管理**:
- 创建和修改规则时,条件(conditions)和行动(actions)参数从可选变为必填,强调了规则定义的完整性。
4. **文档结构变化**:
- 网络结构部分被整合到概述部分,成为一级节点。
- 兼容性说明和消息推送功能分别更名为“API使用声明”和“推送通知”,并重新组织了章节位置。
- Beta接口内容得到了补充,可能预示着平台的进一步扩展和新功能的测试阶段。
5. **设备管理**:
- 新增了`deviceInfo`和`productId`参数,允许更精确地注册直连设备。
- `customFields`、`imsi`、`ip`和`tags`参数的添加,增强了设备信息的灵活性。
6. **批量处理**:
- 批量任务创建和查询功能得到增强,如`groupTag`参数的加入,以及新增的`taskType`和`type`参数选项,方便处理大量设备操作。
通过这份文档,开发者可以了解到中国电信物联网开放平台API的最新特性,从而有效地集成到自己的项目中,实现物联网设备的高效管理和数据交互。对于想要利用NB-IoT技术进行产品开发或应用集成的团队和个人来说,这是一份不可或缺的参考资料。