文档平台 API 中心 物联卡 查询卡片列表

查询卡片列表

最近更新时间:2018-04-04 18:23:35

接口描述

功能描述

用于查询应用关联的物联卡片列表的接口为 getcardlist,当前版本号为 v1。

接口域名

https://yun.tim.qq.com/v1/iotcard/getcardlist?sdkappid=xxxxxxxx&random=xxxxxxxx

请求参数

{
    "teleoperator": 1,
    "limit": 20,
    "offset": 0,
    "token": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4",
    "time": "1505812393",
    "echo": ""
}

参数名称 描述 类型 必选
teleoperator 运营商代码,0 为全部运营商,1 为移动,2 为电信,3 为电信 整数
limit 一页返回最大条目数量,最大为 20 整数
offset 查找时使用偏移 整数
token 鉴权 TOKEN 字符串
time 请求时间,UNIX 时间戳 整数
echo 服务端按原样带回 字符串

注:
token 计算方式:
token = sha256("action=getcardlist&appkey=xxxxxxx&random=xxxxxx&time=xxxxxxxx")

响应参数

{
    "code": 0,
    "message": "OK",
    "echo": "",
    "data": {
        "card_brief_infos": [
            {
                 "iccid": "898602B7091701054333",   
                 "msisdn": "1064878384333",        
                 "teleoperator": 1,                
                 "type": 1,                         
                 "card_status": 1,                  
                 "network_status": 1,               
                 "data_used_in_period": 14.970,     
                 "data_total_in_period": 30.000    
            },
            {
                 "iccid": "898607B0101730318875",
                 "msisdn": "1064706584079",
                 "teleoperator": 1,
                 "type": 1,
                 "card_status": 1,
                 "network_status": 0,
                 "data_used_in_period": 14.170,
                 "data_total_in_period": 30.000
            },
            {
                 "iccid": "898607B0101730321069",
                 "msisdn": "1064706586274",
                 "teleoperator": 1,
                 "type": 1,
                 "card_status": 1,
                 "network_status": 0,
                 "data_used_in_period": 12.170,
                 "data_total_in_period": 30.000
            }
        ]
    }
}

参数名称 描述 类型 必选
code 请求返回码,0 为成功,非 0 为失败 整数
message 请求返回信息 字符串
echo 服务端按原样带回 字符串
data 应答数据 对象

data 对象定义如下:

参数名称 描述 类型 必选
card_brief_infos 物联卡信息 数组

card_brief_infos 数组定义如下

参数名称 描述 类型 必选
iccid 物联卡 iccid 字符串
msisdn 物联卡电话号码 字符串
teleoperator 物联卡运营商代码,1 为移动,2 为电信,3 为联通 整数
type 物联卡服务类型,1 为单卡,2 为流量池 整数
card_status 物联卡状态,1 为未激活,2 为已激活,3 为已停用 整数
network_status 物联卡网络状态, 1 为关闭,2 为打开 整数
data_used_in_period 物联卡当期已使用流量,单位 MB 浮点数
data_total_in_period 物联卡当期可用流量,单位 MB 浮点数

如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >