docs: 为006绑定回执增加ICCID

This commit is contained in:
stu2not
2026-09-20 12:03:40 +08:00
parent 4e91a534aa
commit 5e163c4bb7
2 changed files with 19 additions and 27 deletions
+6 -19
View File
@@ -54,22 +54,7 @@ sequenceDiagram
## Binding Response (V2.0)
The current V2.0 protocol defines the successful `msg_id=006` response as:
```json
{
"msg_id": "006",
"status": "success",
"data": {
"uuid": "53D22B6DA20001"
}
}
```
The V2.0 response does not define an `iccid` field. Adding ICCID to the
binding receipt is therefore a protocol extension that requires coordinated
firmware and backend changes. A compatible proposal is to add it under
`data`, while preserving the existing `status` and `data.uuid` fields:
The V2.0 protocol defines the successful `msg_id=006` response as:
```json
{
@@ -83,9 +68,11 @@ firmware and backend changes. A compatible proposal is to add it under
```
The ICCID must come from the authoritative IMEI-to-ICCID provisioning record
or a validated device report; it must not be derived from the IMEI. This
proposed field is not part of the current V2.0 contract until both sides
accept and implement the extension.
The `iccid` field is now part of the documented `006` success receipt. It must
come from the authoritative IMEI-to-ICCID provisioning record or a validated
device report; it must not be derived from the IMEI. Firmware and backend
runtime support still need to be deployed together before this field can be
relied on in production.
## Related Tables
+6 -1
View File
@@ -163,10 +163,15 @@ device/imei/response
"msg_id": "006",
"status": "success",
"data": {
"uuid": "53D22B6DA20001"
"uuid": "53D22B6DA20001",
"iccid": "898604E91123D1334901"
}
}
其中 `iccid` 为完成绑定的设备 SIM 卡 ICCID,由设备或后端登记数据提供,
必须使用完整值,不得根据 IMEI 推导。旧设备如果未上报该字段,后端应按协议
兼容策略处理;支持新版协议的设备绑定成功回执必须返回 `iccid`。
7、开关状态
//0查询状态 1 控制打开 2控制关闭
device/imei/command