添加SIM卡至指定分组

Cube UAT

POST

/mall/bundle-groups/{group_id}/sims

适用场景

需要将一张或多张 SIM 卡批量加入到指定的 SIM-套餐分组（由 group_id 标识）中；

必要条件

请求方法必须为 POST；

group_id 为 BBC 系统中 SIM-套餐分组的唯一标识；

注意事项

接口采用同步响应 + 异步执行：

同步阶段仅返回参数格式、权限等基础校验结果；

实际的分组添加操作在后台异步执行。；

可以通过返回头中的 request_id 在异步结果获取接口获取异步结果；

业务规则

仅支持向已存在的有效分组（group_id 合法且未被删除）中添加 SIM 卡；

同一张 SIM 卡若已在分组中，无法再进行添加分组；

SIM卡所属与添加的分组的原始套餐需要保持一致；

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "sim_ids": [
        "389852123456789098762", 
        "389852123456789098763",
        "389852123456789098764",
        "389852123456789098765"
    ],
    "partnerCode": "P000270",
    "sign":"ea7a3bba7e345e0b8ca7f7e3b43d6e72",
    "version": "3.0"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/mall/bundle-groups//sims' \
--header 'Content-Type: application/json' \
--data '{
    "sim_ids": [
        "389852123456789098762", 
        "389852123456789098763",
        "389852123456789098764",
        "389852123456789098765"
    ],
    "partnerCode": "P000270",
    "sign":"ea7a3bba7e345e0b8ca7f7e3b43d6e72",
    "version": "3.0"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "data": {
        "sim_total_quantity":105
    },
    "operateCode": "S",
    "message": "success"
    
}

🟢200success

修改于 2026-01-29 05:44:50

充值成功消息推送

从指定分组删除SIM卡

添加SIM卡至指定分组

适用场景#

必要条件#

注意事项#