激活（异步）

适用场景

当SIM卡服务合约有效期内，且有未启用套餐时，立即启用一个未启用的套餐

必要条件

仅支持对所用API key归属企业下的卡片进行操作。

SIM需同时满足非OTA卡、有未启用的套餐、服务合约未到期三个条件时适用。

注意事项

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

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

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

通过notification api回调获取结果 pending

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

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

业务规则

激活处理成功后，SIM卡添加的套餐状态将进行如下变更：

激活前SIM卡没有使用中状态的套餐，将添加时间最早的未启用套餐A状态变更为使用中。

激活前SIM卡有使用中状态的套餐A，将添加时间最早的未启用套餐B状态变更为使用中，同时将原使用中的套餐A变更为暂停。

激活操作的异步处理结果可能会失败，当结果为失败时，用户可再次发起激活操作。

状态码

主要描述本接口中data.code中的返回码及对应的错位原因

cede	message	solution
CB-01-0001	该SIM卡信息不存在	请检测ICCID是否为领科提供，或该ICCID归属企业是否与调用API使用的KeyID归属企业是否一致
CB-01-0204	废弃/停机保合约到期时间已过期卡片无法进行该操作	请联系领科确认SIM卡状态并人工处理
CB-01-0004	支持OTA的SIM卡无法进行此操作	暂不支持此类型卡片操作，请联系领科
CB-01-0007	多IMSI的SIM卡无法进行此操作	暂不支持此类型卡片操作，请联系领科
CB-01-0111	该SIM卡有请求处理中，不允许同时操作	等待同类型处理完成后再次操作
CB-02-0200	该SIM卡无有效的套餐，请先绑定套餐	请通过添加套餐接口绑定套餐
CB-01-0123	SIM卡已激活。	SIM卡状态正常为已激活，无需重复操作
CB-99-9500	系统繁忙，请稍后重试	请稍后再次重试

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v1().service().activateAsync(new ActivateAsync(1, "89314404000894487785"));
client.v2().service().activateAsync(new ActivateAsync(1, "89314404000894487785"));

请求参数

Path 参数

sim_id

string

必需

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

timestamp

string

必需

epoc time UTC

nonce

integer

随机正整数

可选

示例

{
    "timestamp": "string",
    "nonce": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

null

必需

status

object (status)

必需

code

string

必需

message

string | null

必需

detail

必需

示例

{
    "data": null,
    "status": {
        "code": "CB-00-0000",
        "message": "Success",
        "detail": null
    }
}

🟢200success

适用场景#

必要条件#

注意事项#

业务规则#

状态码#

SDK API 调用方式#

请求参数

示例代码

返回响应

适用场景

必要条件

注意事项

业务规则

状态码

SDK API 调用方式