查询指定分组的 SIM 卡号

Cube UAT

GET

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

适用场景

查询其指定 SIM-套餐分组（通过 group_id 标识）下所包含的 SIM 卡号（ICCID）；

必要条件

请求方法必须为 GET；

Query中所有非null参数以key value的JSON String按字典序排列作为签名的数据；

将signContent数据使用md5算法进行加密（默认32位小写字母+数字）

group_id 为有效的 SIM-套餐分组唯一标识；

分组 ID 对应的客户必须与当前 API 请求的归属客户一致；

注意事项

接口为同步接口，调用后立即返回完整查询结果；

若未传递 sim_id，将返回该分组内全量 SIM 卡的 ICCID 列表；

返回的 SIM 卡数量为“按次计数”，即每次添加操作均计入总数，不进行去重统计，需注意重复添加可能导致数量超限；

业务规则

仅返回当前客户有权限的分组及对应的SIM卡；

请求参数

Path 参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/mall/bundle-groups//sims?sim_ids&version&partnerCode&sign' \
--header 'Content-Type: application/json'

返回响应

🟢200成功

application/json

Body

示例

{
    "data": {
        "sim_ids":[]
    },
    "operateCode": "S",
    "message": "success"
}

🟢200success

修改于 2026-01-29 05:45:43

查询所有分组及套餐基本信息

异步结果获取

查询指定分组的 SIM 卡号

适用场景#

必要条件#

注意事项#