iotLCM

Appearance

查询类 ​

查询 SIM 详情 ​

http
POST /route/open/cardInfo

简要描述：查询物联卡基础信息。

请求体：

字段类型说明
typestring查询类型：msisdn / iccid / imsi / vid
cardnostring对应的查询值

请求示例：

json
{
    "Param": {
        "type": "iccid",
        "cardno": "89860400000000005474"
    },
    "verify": {
        "timeStamp": "1784097284347",
        "password": "example-password",
        "appId": "example-app-id",
        "sign": ""
    }
}

响应结构：

字段类型说明
vidstring本地卡记录 ID
msisdnstringMSISDN
iccidstringICCID
imsistringIMSI
imeistringIMEI
deptNamestring当前归属组织名称
statusIdnumber状态编码，参考公共字典
packageIdstring当前套餐编码
packageNamestring当前套餐名称
usednumber当前周期已用流量，单位 MB
remainingnumber当前周期剩余流量，单位 MB
typestring卡类型名称
packetArrarray资费计划，未配置时返回 null
remarkstring备注
groupingstring分组，未配置时为空字符串
deliverDatestring发货日期，未配置时为空字符串
activateDatestring激活日期
expireTimestring到期时间

响应示例：

json
{
    "status": 0,
    "message": "",
    "result": {
        "vid": "3933",
        "msisdn": "1441543605474",
        "iccid": "89860400000000005474",
        "imsi": "460087436015474",
        "imei": "",
        "deptName": "示例企业",
        "statusId": 4,
        "packageId": "yd-100m-3y",
        "packageName": "每月100m3年",
        "used": 0.875,
        "remaining": 99.125,
        "type": "",
        "packetArr": null,
        "remark": "测试卡",
        "grouping": "",
        "deliverDate": "",
        "activateDate": "2026-06-01",
        "expireTime": "2029-01-31 23:59:59"
    }
}

查询 SIM 账期用量 ​

http
POST /route/open/simDataUsage

请求体：

字段类型说明
iccidstringICCID

请求示例：

json
{
    "Param": {
        "iccid": "89860400000000005474"
    },
    "verify": {
        "timeStamp": "1784097284347",
        "password": "example-password",
        "appId": "example-app-id",
        "sign": ""
    }
}

响应结构：

字段类型说明
useUnitstring单位，当前为 MB
useAmountnumber当前周期已用流量

响应示例：

json
{
    "status": 0,
    "message": "",
    "result": {
        "useUnit": "MB",
        "useAmount": 0.875
    }
}

查询 SIM 历史月用量 ​

http
POST /route/open/simDataUsageMonthly

请求体：

字段类型说明
iccidstringICCID
dateTimestring查询月份，格式 yyyyMM（示例：202509）

请求示例：

json
{
    "Param": {
        "iccid": "89860400000000005474",
        "dateTime": "202509"
    },
    "verify": {
        "timeStamp": "1784097284347",
        "password": "example-password",
        "appId": "example-app-id",
        "sign": ""
    }
}

响应结构：

字段类型说明
useUnitstring单位，当前为 MB
useAmountnumber指定月份用量

响应示例：

json
{
    "status": 0,
    "message": "",
    "result": {
        "useUnit": "MB",
        "useAmount": 0
    }
}

查询 SIM 状态 ​

http
POST /route/open/simStatus

请求体：

字段类型说明
iccidstringICCID

请求示例：

json
{
    "Param": {
        "iccid": "89860400000000005474"
    },
    "verify": {
        "timeStamp": "1784097284347",
        "password": "example-password",
        "appId": "example-app-id",
        "sign": ""
    }
}

响应结构：

字段类型说明
statusMessagestring状态描述
statusCodenumber状态编码，参考公共字典

响应示例：

json
{
    "status": 0,
    "message": "",
    "result": {
        "statusMessage": "已激活",
        "statusCode": 4
    }
}

查询 SIM 在线会话 ​

http
POST /route/open/simSession

请求体：

字段类型说明
iccidstringICCID

请求示例：

json
{
    "Param": {
        "iccid": "89860400000000005474"
    },
    "verify": {
        "timeStamp": "1784097284347",
        "password": "example-password",
        "appId": "example-app-id",
        "sign": ""
    }
}

响应结构：

字段类型说明
typeNamestring运营商系统类型，未上报时为空字符串
imeistringIMEI，未上报时为空字符串
statusMessagestring状态描述，未上报时为空字符串
statusCodenumber状态码，未上报时为 0
dataobject会话详情

data 字段：

字段类型说明
apnIdstringAPN ID
ratstring接入方式
ipv6stringIPv6 地址
ipstringIPv4 地址
ipv6PrefixstringIPv6 前缀
statusstring在线状态
createDatestring会话创建时间

响应示例：

json
{
    "status": 0,
    "message": "",
    "result": {
        "typeName": "",
        "imei": "",
        "statusMessage": "",
        "statusCode": 0,
        "data": {
            "apnId": "",
            "rat": "",
            "ipv6": "",
            "ip": "",
            "ipv6Prefix": "",
            "status": "",
            "createDate": ""
        }
    }
}

查询卡列表信息 ​

http
POST /route/open/queryCardInfoList

请求体：

字段类型说明
iccidarray<string>ICCID 列表，最多支持 100 个

请求示例：

json
{
    "Param": {
        "iccid": [
            "89860400000000005473",
            "89860400000000005474"
        ]
    },
    "verify": {
        "timeStamp": "1784097284347",
        "password": "example-password",
        "appId": "example-app-id",
        "sign": ""
    }
}

响应结构：

字段类型说明
iccidstringICCID
activateDatestring激活日期
dueExpireTimestring到期时间
imeistringIMEI
imsistringIMSI
msisdnstringMSISDN
typestring卡类型
remarksstring备注
statusnumber状态编码，参考公共字典

响应示例：

json
{
    "status": 0,
    "message": "",
    "result": [
        {
            "iccid": "89860400000000005473",
            "activateDate": "2023-05-11",
            "dueExpireTime": "",
            "imei": "",
            "imsi": "460087436015473",
            "msisdn": "1441543605473",
            "type": "",
            "remarks": "测试卡",
            "status": 4
        },
        {
            "iccid": "89860400000000005474",
            "activateDate": "2026-06-01",
            "dueExpireTime": "2029-01-31 23:59:59",
            "imei": "",
            "imsi": "460087436015474",
            "msisdn": "1441543605474",
            "type": "",
            "remarks": "测试卡",
            "status": 4
        }
    ]
}

iotLCM 文档中心