SIM卡划拨

接口定义

适用场景：具有上下级关系（可跨级）或同一上级的组织间划拨SIM卡。

处理方式

同步响应：API立即返回基础校验结果（如参数格式、权限验证）。

异步执行：划拨操作进入任务队列，通过 request_id 跟踪进度。

数据校验规则

校验项	校验阶段	说明
划拨目标组织ID	前置校验	验证目标组织是否存在且有效；SIM卡划拨的目标组织应属于API调用组织的下级。
总数量	前置校验	SIM 卡总计数（不排重），是否超过最大数量 10000
SIM卡ICCID	后置校验	在异步执行阶段验证SIM卡状态、归属权、SOW配置（规则与工单页面划拨一致）。
组织校验规则	后置校验	当前 SIM 卡归属的运营组织必须是 API 调用组织，或下级组织。API 调用组织，当前 SIM 卡归属的结算组织，与目标结算组织必须一致

异步结果获取

主动查询
调用查询异步处理结果，根据响应头中的request_id获取划拨结果。

Webhook推送
在Cube开发者模块配置Webhook回调地址，系统在异步任务完成后自动推送结果至指定URL。

错误码

code	message	处理方式
CB-06-0001	目标组织ID不存在	核实组织ID是否正确
CB-01-0140	单次请求中总计ICCID数量超过10000	减少请求中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

sim_ids

array[string]

必需

SIM卡ICCID，必填，最多支持10,000个

target_org_id

string

划拨目标组织ID

必需

示例

{
  "sim_ids": [
    "389852123456789098762",
    "389852123456789098763",
    "389852123456789098764",
    "389852123456789098765"
  ],
  "target_org_id": "CU-8080VDVFBJGQ"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

必需

sim_total_quantity

integer

必需

划拨的ICCID数量（系统自动去重、去空）

status

object

必需

code

string

必需

message

string

必需

detail

string

必需

示例

{
  "data": {
    "sim_total_quantity": 105
  },
  "status": {
    "code": "CB-00-0000",
    "message": "Success",
    "detail": "https://apidoc-en.iotcube.link"
  }
}

🟢200success

接口定义#

处理方式#

数据校验规则#

异步结果获取#

错误码#

请求参数

示例代码

返回响应

接口定义

处理方式

数据校验规则

异步结果获取

错误码