Cube API Enterprise (CN) 
激活（异步）
POST/sims/{sim_id}/activate适用场景
- 当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
必需
Body 参数application/json
timestamp
string
必需
epoc time UTC
nonce
integer
随机正整数
示例
{
"timestamp": "string",
"nonce": 0
}示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
null
必需
status
#/definitions/41430733必需
示例
{
"data": null,
"status": {
"code": "CB-00-0000",
"message": "Success",
"detail": null
}
}最后修改时间： 1 年前