查询 IMEI(即将推出)
查询设备蜂窝通信模块的 IMEI,用于设备识别、资产登记和通信问题定位。
能力预告
该接口尚未开放调用。以下内容用于介绍计划支持的场景,正式接口以发布时的文档为准。
计划使用方式
调用方可以查询账号下有权访问设备的 IMEI,平台将返回标准化结果。
IMEI 通常属于相对稳定的设备身份信息。正式响应会提供数据采集时间,帮助调用方判断数据来源和时效。
计划响应字段
接口将返回标准响应外层结构,以下字段位于 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
deviceId | string | 是 | 设备 ID |
imei | string | 是 | 蜂窝通信模块 IMEI,固定为 15 位十进制数字字符串 |
collectedAt | string | 是 | 本次数据采集时间,RFC3339 UTC |
imei 使用字符串返回,避免数值类型导致精度或格式变化。平台只会接受通信模块明确返回且符合 15 位数字格式的数据;无效值不会覆盖已经确认的 IMEI。
数据保护
- IMEI 只对有权访问该设备的 API Client 返回。
- 调用方不应在公开日志、浏览器地址或前端错误信息中完整输出 IMEI。
- 设备或通信模块不支持该信息时,接口会返回明确的能力或数据不可用结果。
字段依据
IMEI 的格式依据 SIMCom A76XX 官方设备序列号查询定义。OpenAPI 仅返回经过格式校验的标准字段,不向调用方暴露模块通信细节。
正式发布后
正式接口文档将提供请求路径、权限要求、数据更新时间,以及设备离线、不支持或暂未采集到 IMEI 时的返回规则。
