选择并锁定本地网络

简要描述

版本：

v4

适用场景

与领科协商并预先配置完成后，使用特定套餐的SIM卡在指定地区，可选择并限定本地网入网运营商

国家	mcc	运营商	mnc
美国	310	ATT	410
美国	310	Verizon	480
美国	310,311	verizon+ATT	410,480

必要条件

1. API key归属企业与SIM卡归属企业相同。
2. SIM卡状态为使用期。
3. SIM卡当前的套餐支持此操作。（详询领科支持人员）

注意事项

1. 操作的处理为异步，接口同步响应成功代表领科系统接收请求成功。
2. 获取操作异步处理结果的方式：
   1. 使用接口响应header中的request_id通过查询异步操作结果进行处理结果查询。
   2. 通过notification api回调获取结果 pending
3. 当操作异步处理结束前，卡片处于锁定状态，此时禁止对同一SIM进行激活、停机、复机、重置等操作。
4. 异步处理过程通常可在几秒内结束，若运营商系统发生网络拥塞等异常，处理时长可达几十分甚至更长。
5. 异步操作处理结果为失败时，用户可再次发起操作。

SDK API 调用方式

支持SDK最低版本：1.0.12

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().service().selectedLocalOperators(new SelectedLocalOperators(1, "89430101521032290021","310,311","410,480"));
client.v2().service().selectedLocalOperators(new SelectedLocalOperators(2, "89430101521032290021","310,311","480,410"));
client.v2().service().selectedLocalOperators(new SelectedLocalOperators(3, "89430101521032290021","311,310","410,480"));
client.v2().service().selectedLocalOperators(new SelectedLocalOperators(4, "89430101521032290021","311,310","480,410"));
client.v2().service().selectedLocalOperators(new SelectedLocalOperators(5, "89430101521032290021","310","410"));

{
  "country": "310,311",
  "local_operators": "410,480"
}

{
  "data": {
    "code": "CB-00-0099",
    "message": "Request received, asynchronous processing."
  },
  "status": {
    "code": "CB-00-0000",
    "message": "成功",
    "detail": "https://apidoc-en.iotcube.link/"
  }
}