1.URL

xxxxxxxxxxxxxxx/system/asset/sim/querySimInfoByTerminalId
其中xxxxxxxxxxxxxxx为节点URL（详情参考：对接说明中4.服务器节点说明）
（上海节点）http://124.223.60.234:8080/system/asset/sim/querySimInfoByTerminalId
（美国节点）https://cloud.aovx.com/prod/system/asset/sim/querySimInfoByTerminalId

2.请求参数

2.1请求头

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

2.2.参数示例

{
    "terminalId":"665CF6356FF147F384A71408CAB7066C"
}

2.3.参数说明

字段	类型	说明	是否必须
terminalId	String	设备唯一标识	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.测试示例

作者：admin 创建时间：2023-09-18 12:01
最后编辑：admin 更新时间：2025-04-26 15:43

查询SIM卡信息