查询SIM卡下的套餐列表

适用场景

适用于需要查询特定 SIM 卡下的所有套餐列表。

支持查询 OTA 卡和非 OTA 卡下的套餐列表。

必要条件

调用方为企业客户；

请求方法必须为 GET；

调用方需确保拥有对该 SIM 卡的操作权限；

注意事项

接口支持分页查询，每页最多可展示 100 条记录。默认情况下，查询第一页，包含 100 条数据；

如果要通过套餐状态筛选查询结果，可以使用状态参数（0-未启用、1-使用中、2-已暂停、3-已结束），默认情况下返回未启用、使用中和已暂停的套餐。

业务规则

查询结果包含该 SIM 卡下所有的套餐；

返回的数据优先按照状态排序，相同状态的数据，按添加时间 add at 倒序排列；

默认情况下，查询会返回处于“使用中”、“暂停”以及“未启用”的套餐；

版本

X-LF-Signature-Type：2.0

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().sim().queryBundles(new QueryBundles(12, "89852202306250040073"))

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "data": [
        {
            "id": "LP20230619004077",
            "status": 1,
            "type": 1,
            "use": 3,
            "data_limit": -1,
            "period_unit": 2,
            "period_number": 1,
            "cycles": 20,
            "current_cycle": 1,
            "current_cycle_start_at": 1688109330000,
            "current_cycle_end_at": 1688140799000,
            "current_cycle_usage": null,
            "added_at": 1688109329000,
            "start_at": 1688109330000,
            "end_at": null,
            "order_id": "SO-1234521242454"
        },
        {
            "id": "LP20230619004077",
            "status": 2,
            "type": 1,
            "use": 3,
            "data_limit": -1,
            "period_unit": 2,
            "period_number": 1,
            "cycles": 36,
            "current_cycle": 1,
            "current_cycle_start_at": 1687748724000,
            "current_cycle_end_at": 1688140799000,
            "current_cycle_usage": null,
            "added_at": 1687744371000,
            "start_at": 1687748724000,
            "end_at": null,
            "order_id": "SO-1234521242454"
        },
        {
            "id": "LP20230619004077",
            "status": 0,
            "type": 1,
            "use": 3,
            "data_limit": -1,
            "period_unit": 2,
            "period_number": 1,
            "cycles": 15,
            "current_cycle": null,
            "current_cycle_start_at": null,
            "current_cycle_end_at": null,
            "current_cycle_usage": null,
            "added_at": 1688109456000,
            "start_at": null,
            "end_at": null,
            "order_id": "SO-1234521242454"
        },
        {
            "id": "LP20230619004077",
            "status": 0,
            "type": 1,
            "use": 3,
            "data_limit": -1,
            "period_unit": 2,
            "period_number": 1,
            "cycles": 3,
            "current_cycle": null,
            "current_cycle_start_at": null,
            "current_cycle_end_at": null,
            "current_cycle_usage": null,
            "added_at": 1688607448000,
            "start_at": null,
            "end_at": null,
            "order_id": "SO-1234521242454"
        },
        {
            "id": "LP20230619004077",
            "status": 0,
            "type": 1,
            "use": 3,
            "data_limit": -1,
            "period_unit": 2,
            "period_number": 1,
            "cycles": 3,
            "current_cycle": null,
            "current_cycle_start_at": null,
            "current_cycle_end_at": null,
            "current_cycle_usage": null,
            "added_at": 1688607493000,
            "start_at": null,
            "end_at": null,
            "order_id": "SO-1234521242454"
        }
    ],
    "status": {
        "code": "CB-00-0000",
        "message": "成功",
        "detail": "https://apidoc-cn.iotcube.link"
    },
    "total_count": 5
}

🟢200success

适用场景#

必要条件#

注意事项#

业务规则#

版本#

SDK API 调用方式#

请求参数