语音卡批量查询

接口功能

批量查询语音卡信息接口。

变更记录

接口版本	更新时间	更新人	更新说明
1.0.0	2025-06-17	李闯	批量查询语音卡信息接口

接口原型

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

请求参数

参数	是否必填	类型	示例	描述
userName	是	String	zhangsan	用户名
passWord	是	String	123456	加密后密码,加密规则参照密码加密规则
tKey	是	String	20181019130530	当前时间,tKey生成规则参照tKey规则
cardType	是	int	1	卡属性：1.单卡；2.池卡 (默认为1)
pageNum	是	int	1	分页查询，当前第几页（默认为1）
pageSize	否	int	10	每页多少条数据,默认10,最大100
iccid	否	String	89860412101871055784-8986041210187105594	iccid（19、20）位，查询一段，首号和尾号之间用”-“连接
msisdn	否	String	1440533596137-1440533596139	卡号（11 - 15）位，查询一段，首号和尾号之间用”-“连接
cardStatus	否	int	1	卡状态:1.正常 2.停机 3.沉默期 5.测试期 6.停机保号
operator	否	int	1	运营商（1.移动2.联通3.电信）
beginOpenCardTime	否	String	2025-06-06 16:45:18	开卡日期开始查询时间
endOpenCardTime	否	String	2025-06-12 16:45:18	开卡日期截止查询时间
beginPackageTime	否	String	2025-06-06	卡到期日期开始查询时间
endPackageTime	否	String	2025-06-06	卡到期日期截止查询时间
flowUnit	否	String	MB	根据传值设定响应值（总流量、已使用量、剩余流量）的单位,支持传值:KB MB GB TB PB EB,不传系统将按照流量大小自动转换单位
orderId	否	String	202506021613425698	购卡订单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,
                                        "packageId": "596",
                                        "packageName": "移动小流量100M",
                                        "totalFlow": "100MB",
                                        "cardFlow": "10MB",
                                        "leftFlow": "90MB",
                                        "talkTime": "130",
                                        "useTalkTime": "130",
                                        "openCardTime": "2018-09-19 09:11:12",
                                        "lastActivateTime": "2020-08-07",
                                        "activateTime": "2018-09-19",
                                        "packageTime": "2018-09-30",
                                        "remark": "test",
                                        "channelId": "71",
                                        "orderId": "202308021613425698",
                                        "buyTime": 12
                                    }
                                ]
                            }
                        }

成功：

失败：

响应参数

参数			类型	示例	描述
status			int	0	返回状态 0成功，非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.池卡
		cardStatus	int	1	卡状态：1.正常 2.停机 3.沉默期 5.测试期 6.停机保号
		operator	int	1	运营商：1.移动 2.联通 3.电信
		packageId	int	19	资费包id
		packageName	String	移动小流量100M	套餐包名
		totalFlow	String	100MB	总流量
		cardFlow	String	10MB	已使用流量
		leftFlow	String	90MB	剩余流量
		talkTime	int	130	总语音时长，单位分钟
		useTalkTime	int	130	使用语音时长，单位分钟
		openCardTime	String	2025-06-02 12:13:14	开卡日期（卡片出库时间）
		lastActivateTime	String	2025-06-06	激活宽限期（强制激活时间）
		activateTime	String	2025-06-10	激活时间
		packageTime	String	2025-06-30	到期时间
		remark	String	测试	卡备注信息
		channelId	String	71	通道号，卡所属通道
		orderId	String	202506021613455689	购卡订单ID
		buyTime	int	12	购买时长，套餐不变情况下时长累计，套餐变化时长重置