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数量

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

示例

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

接口定义

处理方式

数据校验规则

异步结果获取

错误码

请求参数

请求示例代码

返回响应

SIM卡划拨

接口定义#

处理方式#

数据校验规则#

异步结果获取#

错误码#

请求参数

请求示例代码

返回响应

接口定义

处理方式

数据校验规则

异步结果获取

错误码