1.URL

http://124.223.60.234:8080/system/asset/sim/querySimInfo

2.请求参数

2.1请求头

token:对应登录验证成功后，data里面对应的tokenId

2.2.参数示例

{
    "iccid":"89314404001235546594"
}

2.3.参数说明

字段 类型 说明 是否必须
iccid String ICCID Y

3.接口应答

3.1.返回示例

{
    "code": 200,
    "message": "Operation succeeded",
    "data": {
        "iccid": "89314404001235546594",
        "simOperatorType": 1,
        "accessKey": "F999710D3E5C45DEA45D378F536CA95B",
        "status": 23,
        "start_at": 1681371995000,
        "end_at": 1725119999000,
        "bundles": [
            {
                "id": "LP20220707004658",
                "status": 1,
                "type": 1,
                "use": 1,
                "data_limit": 20971520,
                "period_unit": 2,
                "cycles": 12,
                "current_cycle": null,
                "current_cycle_start_at": 1693497600000,
                "current_cycle_end_at": 1696089599000,
                "current_cycle_usage": 5519544,
                "start_at": 1688652218000,
                "end_at": 1719763199000
            }
        ],
        "usageList": [
            {
                "period": "2023-09-04",
                "usage": 678
            },
            {
                "period": "2023-09-05",
                "usage": 75722
            },
            {
                "period": "2023-09-06",
                "usage": 1383722
            },
            {
                "period": "2023-09-07",
                "usage": 979875
            },
            {
                "period": "2023-09-10",
                "usage": 113491
            }
        ]
    }
}

3.2.返回结果说明

字段 类型 说明
code int 返回状态
message String 返回结果描述
data object 返回结果体

data说明

字段 类型 说明
iccid String SIM卡的ICCID
simOperatorType int 运营商名称（1：vodafone；暂时先对接了这家，后续会集成中移动，联通等；暂时显示其他）
status int SIM卡状态（10：静默期；23：使用期；30：暂停期；40：停机保号；50：废弃期）
start_at long SIM卡服务启用毫秒级UNIX时间戳
end_at long SIM卡服务结束毫秒级UNIX时间戳
bundles List SIM卡套餐信息
usageList List SIM卡套餐使用趋势

bundles说明

字段 类型 说明
id String 套餐ID
status int 套餐状态（0：未启用；1：使用中；2：已暂；3：已结束）
type int 套餐类型（0：基础套餐；1：加油包）
use int 套餐用途（0：商用；1：POC测试；2：内部测试）
data_limit int 套餐总流量（单位：byte）
period_unit int 套餐周期类型（1：日；2：月；3：年）
cycles int 购买周期数
current_cycle_start_at long 当前周期开始UNIX时间戳
current_cycle_end_at long 当前周期结束UNIX时间戳
current_cycle_usage int 当前周期套餐使用量（单位：byte）
start_at long 套餐购买日期UNIX时间戳
end_at long 套餐结束日期UNIX时间戳

usageList说明

字段 类型 说明
period String 日期
usage int 当日使用量（单位：byte）

4.测试示例

Author：admin  Create time：2023-09-11 13:55
Last editor：admin  Update time：2025-10-31 14:50