恢复初始设置(异步)
PUT
/sims/{sim_id}/reinitialize简要描述
版本:
v4
适用场景
SIM卡随设备交付给终端用户后,出现了退货等售后问题,需要将SIM卡绑定的套餐、SIM卡状态等数据还原至领科交付给客户时的初始状态。
使用此功能会产生额外账单,详情咨询领科商务人员。
必要条件
- API key归属企业与SIM卡归属企业相同。
- SIM卡不支持OTA功能。
- SIM卡状态不能为静默期、废弃期(或停机保状态但停机保号时间已到期)。
注意事项
- 操作的处理为异步,接口同步响应成功代表领科系统接收请求成功。
- 获取操作异步处理结果的方式:
- 使用接口响应header中的request_id通过查询异步操作结果进行处理结果查询。
- 通过notification api回调获取结果 pending
- 当操作异步处理结束前,卡片处于锁定状态,此时禁止对同一SIM进行激活、停机、复机、重置等操作。
- 异步处理过程通常可在几秒内结束,若运营商系统发生网络拥塞等异常,处理时长可达几十分甚至更长。
- 异步操作处理结果为失败时,用户可再次发起操作。
SDK API 调用方式
支持SDK最低版本:1.0.11
PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().service().reinitialize(new ReinitializeSim(1, "80049352817413355108"))
请求参数
Path 参数
sim_id
string
SIM卡ICCID
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
必需
Any of
status
#/definitions/41430733必需
示例
{
"data": {
"code": "CB-00-0099",
"message": "Request received, asynchronous processing."
},
"status": {
"code": "CB-00-0000",
"message": "成功",
"detail": "https://apidoc-en.iotcube.link/"
}
}
最后修改时间: 8 个月前