Linksfield Developer
OverviewCube APIsTopup APIs
旧版本API
OverviewCube APIsTopup APIs
旧版本API
  1. Bundle-groups
  • Mall全局说明
  • Mall业务流程
  • Mall签名代码示例
  • APP调用Stripe的SDK示例说明
  • Vshop
    • 卡片登录验证
      POST
    • 获取可购套餐商品列表
      POST
    • 创建用户订单
      POST
    • 查询正在使用、未启用订单
      POST
    • 获取生效中的自动续费
      POST
    • 关闭自动续费
      POST
    • 用户下单(第三方支付)
      POST
  • Payment
    • 获取stripe单次支付权限
      POST
    • 获取Stripe订阅支付权限
      POST
    • 创建Stripe订阅/自动续费
      POST
    • 支付结果查询
      POST
  • Notification
    • 充值成功消息推送
      POST
  • Bundle-groups
    • 添加SIM卡至指定分组
      POST
    • 从指定分组删除SIM卡
      DELETE
    • 查询所有分组及套餐基本信息
      GET
    • 查询指定分组的 SIM 卡号
      GET
    • 异步结果获取
      GET
  • Order
    • 订单详情查询
      GET
  1. Bundle-groups

查询指定分组的 SIM 卡号

Cube UAT
Cube UAT
GET
/mall/bundle-groups/{group_id}/sims

适用场景#

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

必要条件#

1.
请求方法必须为 GET;
2.
Query中所有非null参数以key value的JSON String按字典序排列作为签名的数据;
3.
将signContent数据使用md5算法进行加密(默认32位小写字母+数字)
4.
group_id 为有效的 SIM-套餐分组唯一标识;
5.
分组 ID 对应的客户必须与当前 API 请求的归属客户一致;

注意事项#

1.
接口为 同步接口,调用后立即返回完整查询结果;
2.
若未传递 sim_id,将返回该分组内 全量 SIM 卡的 ICCID 列表;
3.
返回的 SIM 卡数量为“按次计数”,即每次添加操作均计入总数,不进行去重统计,需注意重复添加可能导致数量超限;

业务规则#

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

请求参数

Path 参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/mall/bundle-groups//sims?sim_ids=undefined&version=undefined&partnerCode=undefined&sign=undefined' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "data": {
        "sim_ids":[]
    },
    "operateCode": "S",
    "message": "success"
}
🟢200success
修改于 2026-01-29 05:45:43
上一页
查询所有分组及套餐基本信息
下一页
异步结果获取
Built with