选择并锁定本地网络

Cube Prod

https://api.linksfield.net/cube/v4

PUT

/sims/{sim_id}/selected_local_operators

简要描述

版本：

v4

适用场景

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

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

必要条件

API key归属企业与SIM卡归属企业相同。

SIM卡状态为使用期。

SIM卡当前的套餐支持此操作。（详询领科支持人员）

注意事项

操作的处理为异步，接口同步响应成功代表领科系统接收请求成功。

获取操作异步处理结果的方式：

使用接口响应header中的request_id通过查询异步处理结果进行处理结果查询。

通过notification api回调获取结果 pending

当操作异步处理结束前，卡片处于锁定状态，此时禁止对同一SIM进行激活、停机、复机、重置等操作。

异步处理过程通常可在几秒内结束，若运营商系统发生网络拥塞等异常，处理时长可达几十分甚至更长。

异步操作处理结果为失败时，用户可再次发起操作。

SDK API 调用方式

支持SDK最低版本：1.0.12

请求参数

Path 参数

sim_id

string

SIM卡ICCID

必需

Header 参数

Accept-Language

string

可选

默认，当header中无语言要求时，默认返回简体中文。当前支持zh-CN（简体中文）、en-US（英文）。/ Support : zh-CN 、 en-US

默认值:

zh-CN

Content-Type

string

可选

默认值:

application/json

Authorization

string

必需

LF {lfAccessKeyId}/{sign} 必填项

默认值:

X-LF-Api-Version

string

可选

默认值: 此最新版本。如最新版本为2.0，则默认1.0

X-LF-Signature-Type

string

1.0、2.0

可选

timestamp

string

必需

毫秒时间戳；只接受10分钟之内请求

nonce

integer

必需

随机正整数，取值范围：0-2147483647

Body 参数application/json

country

string

必需

需要指定网络的目标地区通常为mcc 。当前支持：美国，多个时请用英文逗号分开。请按文档描述部分的mcc-mnc对照表填写。

local_operators

string

必需

需要指定的目标网络通常为mnc，多个时使用英文逗号(,)分隔。当前支持：ATT网络、Verizon网络、ATT+Verizon网络。请按文档描述部分的mcc-mnc对照表填写。

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.linksfield.net/cube/v4/sims//selected_local_operators' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization;' \
--header 'X-LF-Api-Version;' \
--header 'X-LF-Signature-Type;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country": "310,311",
    "local_operators": "410,480"
}'

返回响应

🟢200成功

application/json

Body

data

必需

Any of

status

object

code

string

必需

message

string | null

必需

detail

必需

status

object (status)

必需

示例

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

🟢200success

修改于 2025-04-16 09:59:13

恢复初始设置（异步）

查询客户产品覆盖地

选择并锁定本地网络

简要描述#

版本：#

适用场景#

必要条件#

注意事项#

SDK API 调用方式#

请求参数

示例代码

返回响应

简要描述

版本：

适用场景

必要条件

注意事项

SDK API 调用方式