芯片管理

芯片管理列表分页查询接口

请求 URL：

• http://ip:port/esim/select

请求方式：

• POST

参数形式：

• form-data

参数：

返回：

返回示例

备注

在 esim_info 表中存在的号码为临时号码，不在 esim_info 表中存在的号码为正式号码，

芯片管理添加数据

请求 URL：

• http://ip:port/esim/addEsim

请求方式：

• POST

参数形式：

• form-data

参数：

返回示例

{
  "errcode": 200,
  "code": 200,
  "message": "success",
  "cnmessage": "成功"
}

备注

添加新数据会先根据 eid 或者 imsi 删除原有数据，然后重新创建数据。

芯片管理删除数据

请求 URL：

• http://ip:port/esim/deleteEsim

请求方式：

• POST

参数形式：

• form-data

参数：

返回示例

{
  "errcode": 200,
  "code": 200,
  "message": "success",
  "cnmessage": "成功"
}

备注

首先根据 eid 或者 imsi 删除 esim_info 表数据，
然后根据 imsi 和用户 id（userId）删除 formal_imsi 表数据。

芯片管理写卡

请求 URL：

• http://ip:port/otaapi/createWritecard

请求方式：

• POST

参数形式：

• form-data

参数：

返回示例

{
  "errcode": 200,
  "code": 200,
  "message": "success",
  "cnmessage": "成功"
}

备注

判断 eid，如果 eid 不为空根据 eid 获取 esim_info 和 esim_ec 关联数据；为空根据 imei 获取。
newMsisdn 不能为空，在 esim_ec 表获取对应的信息；
根据 eid 和用户 id 判断在 esim_info 和 esim_ec 关联数据中是否存在对应数据；
根据 newMsisdn 和用户 id 判断在 esim_info 和 esim_ec 关联数据中是否存在对应数据；
usesdk 为 lwm2m 时连接 onenet 创建老设备；
在 writecard_work 表中写入写卡记录
usesdk 为 nosdk 时直接下发，不使用 sdk 需要直接触发设备上线。

临时号和正式号转换

graph TB;
　　临时号-->|eid|esim_info;
　　临时号-->|msisdn|esim_ec;
      esim_info-->|关联关系esim_ec.imsi=esim_info.imsi|esim_ec;

graph TB;
　　正式号-->|imsi|formal_imsi;
　　正式号-->|msisdn|esim_ec;
      formal_imsi-->|关联关系esim_ec.imsi=formal_imsi.imsi|esim_ec;

graph TB;
      临时号-->|eid|esim_info;
　　临时号-->|newMsisdn|esim_ec;
      esim_info-->|关联关系esim_ec.imsi=esim_info.imsi|esim_ec;
　　正式号-->|imsi|formal_imsi;
　　正式号-->|oldMsisdn|esim_ec;
      formal_imsi-->|关联关系esim_ec.imsi=formal_imsi.imsi|esim_ec;

正式号变为临时号：
根据 newMsisdn 查询 esim_ec 表关联 formal_imsi，修改 newMsisdn 为 oldMsisdn
临时号变为正式号：
根据 eid 查询 esim_info 表获取 imsi，
根据 imsi 修改 esim_ec 表中 oldMsisdn 为 newMsisdn

芯片管理下载模板

请求 URL：

• http://ip:port/add_info.xls
• http://ip:port/esim/downloadEsimTemplate

请求方式：

a 标签跳转

• POST

参数形式：

• form-data

参数：

返回示例

备注

直接下载前端模板文件 (无法控制下载文件的权限)

芯片管理批量导入

请求 URL：

• http://ip:port/esim/addEsimByFile

请求方式：

• POST

参数形式：

• excel 文件

参数：

返回示例

备注

添加新数据会先根据 eid 或者 imsi 删除原有数据，然后重新创建数据。

联调测试平台接口目录
下一篇 芯片管理联调平台写卡记录接口梳理