设备网络与身份信息(即将推出)
WLTE OpenAPI 将通过标准 REST API 提供设备网络与身份信息,让你的系统可以用统一方式读取 LTE、IMEI 和 Band 数据。
能力预告
这些接口尚未开放调用。正式发布时,本目录会提供完整的接口路径、字段和使用规则。
即将提供的能力
| 能力 | 用途 | 当前状态 |
|---|---|---|
| 查询 LTE 网络信息 | 获取设备的蜂窝网络状态,用于联网诊断和运维展示 | 即将推出 |
| 查询 IMEI | 获取设备蜂窝通信模块的身份标识,用于资产识别 | 即将推出 |
| 设置 LTE Band | 在设备明确支持的范围内设置首选 LTE Band | 即将推出 |
设计原则
- 对外提供明确的 REST 资源和标准化字段。
- 根据设备类型、通信模块和固件能力决定接口是否可用。
- 查询结果将包含数据采集时间,帮助调用方判断数据时效。
- 不同通信模块通过统一的数据结构提供信息。
- 涉及网络配置的操作必须经过参数校验,并避免并发修改同一设备。
数据来源与边界
计划响应字段依据 SIMCom 官方发布的 A76XX Series AT Command Manual 定义,并由 OpenAPI 转换为稳定的 REST 字段。调用方不需要发送、解析或了解 AT 指令。
- 只公开能够被设备通信模块明确返回、且能够稳定标准化的数据。
- 厂商内部编码会先转换为明确的枚举或物理量;无法确认单位或含义的原始值不会作为正式字段发布。
- 设备型号、地区版本和固件能力不同,实际可用字段以设备能力和接口响应为准。
- IMEI 等设备身份信息仅向有权访问该设备的 API Client 返回。
参考:SIMCom A76XX 官方技术文档、A7672X 型号与频段信息
当前可用方式
这些接口尚未开放。设备在线状态和现有外设数据请继续使用:
正式发布后
接口正式开放时,本目录将提供:
- 请求方法和正式路径
- 权限要求
- 请求与响应字段
- 设备能力判断方式
- 限流和重试规则
- 错误码与兼容范围
