卡信息批量查询接口

典型场景

第三方应用调用此批量查询接口，进行数据查询

接口功能

批量查询卡信息接口

变更记录

接口版本	更新时间	更新人	更新说明
1.0.0	2019-12-09	缪勇	新增批量查询接口
1.0.1	2019-12-17	杨丹丹	参数数据类型修复
1.0.2	2019-12-30	杨康	接口开发完成上线
1.0.3	2021-03-15	缪勇	新增msisdn查询
1.0.4	2023-01-28	邓双玲	响应参数新增channelId、packageId
1.0.5	2023-02-15	邓双玲	响应参数新增imsi
2.0.0	2023-06-06	邓双玲	增加查询卡销户近3个月数据
2.0.1	2023-11-29	邓双玲	响应参数新增imei
2.0.2	2023-12-29	邓双玲	响应参数新增buyTime

接口原型

请求类型	POST
请求地址	https://api.tibiot.com/api/v1/card/batchQueryCardInfo
传输协议	HTTP
Content-Type	application/json
接口说明	卡信息批量查询，此接口组装信息较多，不支持并发请求，接口限制100/分钟

请求参数

参数	是否必填	类型	示例	描述
userName	是	String	zhangsan	用户名
passWord	是	String	123456	加密后密码,加密规则参照密码加密规则
tKey	是	String	20190625143828	当前时间,tKey生成规则参照tKey规则
cardType	是	int	1	卡属性：1.单卡；2.池卡 3.销户卡（默认为1）
pageNum	是	int	1	分页查询，当前第几页（默认为1）
pageSize	否	int	10	每页多少条数据，默认10,最大100
iccid	否	String	89860412101871055784-89860412101871055794	iccid（19、20）位，查询一段，首号和尾号之间用”-”连接
msisdn	否	String	1440533596137- 1440533596139	msisdn（11 - 15）位，查询一段，首号和尾号之间用”-”连接
cardStatus	否	int	1	卡状态：1.正常 2.停机 3.沉默期 5.测试期 6.停机保号
operator	否	int	1	运营商（1.移动 2.联通 3.电信）
beginOpenCardTime	否	String	2019-08-23 16:45:18	开卡日期开始查询时间
endOpenCardTime	否	String	2019-08-23 16:45:18	开卡日期截止查询时间
beginPackageTime	否	String	2019-08-23	卡到期日期开始查询时
endPackageTime	否	String	2019-08-23	卡到期日期截止查询时间
beginDismantleTime	否	String	2023-01-23 16:45:18	销户开始时间（cardType = 3时可用；只可查询近3个月的销户数据）
endDismantleTime	否	String	2023-02-23 16:45:18	销户结束时间（cardType = 3时可用；只可查询近3个月的销户数据）
flowUnit	否	String	MB	根据传值设定响应值（总流量、已使用量、剩余流量）的单位，支持传值：KB MB GB TB PB EB，不传系统将按流量大小自动转换单位
orderId	否	String	202308021613425698	购卡订单ID

请求示例

响应示例

{
                            "status":0,
                            "message":"成功",
                            "data":{
                                "pageNum":1,
                                "pageSize":10,
                                "totalCount":119,
                                "pageCount":12,
                                "records":[
                                    {
                                        "iccid":"898607B5041700064496",
                                        "msisdn":"1064752699496",
                                        "imsi":"852633001536365",
                                        "imei":"6408698556982",
                                        "cardType":2,
                                        "cardStatus":1,
                                        "operator":1,
                                        "packageName":"移动小流量100M",
                                        "totalFlow":"100MB",
                                        "cardFlow":"10MB",
                                        "leftFlow":"90MB",
                                        "openCardTime":"2018-09-19 09:11:12",
                                        "lastActivateTime":"2020-08-07",
                                        "activateTime":"2018-09-19",
                                        "packageTime":"2018-09-30",
                                        "remark":"test",
                                        "channelId":"71",
                                        "packageId":"596",
                                        "dismantleTime":"2023-05-11 16:57:18",
                                        "orderId":"202308021613425698",
                                        "buyTime":12
                                    },{
                                        "iccid":"898607B5041700064497",
                                        "msisdn":"1064752699497",
                                        "imsi":"852633001536367",
                                        "imei":"6408698556983",
                                        "cardType":2,
                                        "cardStatus":2,
                                        "operator":1,
                                        "packageName":"移动小流量100M",
                                        "totalFlow":"100MB",
                                        "cardFlow":"10MB",
                                        "leftFlow":"90MB",
                                        "openCardTime":"2018-09-19 12:14:15",
                                        "lastActivateTime":"2020-08-07",
                                        "activateTime":"",
                                        "packageTime":"",
                                        "remark":"test",
                                        "channelId":"71",
                                        "packageId":"596",
                                        "dismantleTime":"2023-05-11 16:57:16",
                                        "orderId":"202308021613455689",
                                        "buyTime":12
                                    }
                                ]
                            }
                        }

成功：

失败：

响应参数

参数			类型	示例	描述
status			int	0	返回状态
message			String	成功	返回信息
data	pageNum		int	1	页码
	pageSize		int	10	一页多少条
	totalCount		int	119	总条数
	pageCount		int	12	总页数
	records	iccid	String	898607B5041700064496	iccid
		msisdn	String	1064752699496	卡号
		imsi	String	852633001536365	imsi
		imei	String	852633001536365	imei
		cardType	int	1	卡属性：1.单卡；2.池卡 3.销户卡
		cardStatus	int	1	卡状态：1.正常 2.停机 3.沉默期 5.测试期 6.停机保号
		operator	int	1	运营商：1.移动 2.联通 3.电信
		packageName	String	移动小流量100M	套餐包名
		totalFlow	String	100MB	总流量
		cardFlow	String	10MB	已使用流量
		leftFlow	String	90MB	剩余流量
		openCardTime	String	2018-09-19 12:13:14	开卡日期（卡片出库时间）
		lastActivateTime	String	2020-08-07	激活宽限期（强制激活时间）
		activateTime	String	2018-09-19	激活日期
		packageTime	String	2018-09-30	到期日期
		remark	String	test	卡备注信息
		channelId	String	71	通道号，卡所属通道
		packageId	String	596	资费包id
		dismantleTime	String	2023-05-11 16:57:16	销户时间
		orderId	String	202308021613455689	购卡订单ID
		buyTime	int	12	购买时长，套餐不变情况下时长累计，套餐变化时长重置