单张卡详情查询

典型场景

第三方应用调用此查询接口。

接口功能

查询卡详情。

变更记录

接口版本	更新时间	更新人	更新说明
1.0.0	2021-07-21	缪勇	新增单张卡详情查询
1.0.1	2023-01-28	邓双玲	响应参数新增channelId、packageId
1.0.2	2023-02-15	邓双玲	响应参数新增imsi
1.0.3	2023-03-29	邓双玲	响应参数新增网络制式
1.0.4	2023-11-21	缪勇	响应参数新增imei

接口原型

请求类型	POST
请求地址	https://api.tibiot.cn/api/v1/card/queryCardInfo
传输协议	HTTP
Content-Type	application/json
接口说明	单张卡详情查询，卡号、iccid必须传一个。

请求参数

参数	是否必填	类型	示例	描述
userName	是	String	zhangsan	用户名
passWord	是	String	123456	加密后密码,加密规则参照密码加密规则
tKey	是	String	20190625143828	当前时间,tKey生成规则参照tKey规则
iccid	是注：iccid与msisdn有且只能有一个	String	888604221519C0449482	iccid（19、20）位
msisdn	是注：iccid与msisdn有且只能有一个	String	1450220619482	卡号（11 - 15）位
flowUnit	否	String	MB	根据传值设定响应值（总流量、已使用量、剩余流量）的单位，支持传值：KB MB GB TB PB EB，不传系统将按流量大小自动转换单位

请求示例

响应示例

{
                            "status":0,
                            "message":"成功",
                            "data":{
                                "iccid":"888604221519C0449482",
                                "msisdn":"1450220619482",
                                "imsi":"852633001536365",
                                "imei":"46085698258",
                                "cardType":"1",
                                "cardStatus":"1",
                                "operator":"1",
                                "packageName":"移动小流量100M",
                                "totalFlow":"100MB",
                                "cardFlow":"0MB",
                                "lastActivateTime":"2020-08-07",
                                "activateTime":"2020-08-07",
                                "packageTime":"2021-07-31",
                                "remark":"test",
                                "realNameStatus":"0",
                                "channelId":"71",
                                "packageId":"596",
                                "networkType":"4G"
                            }
                        }

成功：

失败情景1：

失败情景2：

其他错误代码请参照“错码说明”

响应参数

参数		类型	示例	描述
status		int	0	返回状态 0成功，非0失败
message		String	成功	返回信息失败为失败说明
data	iccid	String	888604221519C0449482	iccid
	msisdn	String	1450220619482	卡号
	imsi	String	852633001536365	imsi
	imei	String	46085698258	imei
	cardType	String	1	卡类型（1.单卡 2.池卡）
	cardStatus	String	1	卡状态：1.正常 2.停机 3.沉默期 5.测试期 6.停机保号
	operator	String	1	运营商（1.移动 2.联通 3.电信）
	packageName	String	移动小流量100M	套餐包名
	totalFlow	String	100MB	总流量
	cardFlow	String	0MB	已使用流量
	lastActivateTime	String	2020-08-07	激活宽限期（强制激活时间）
	activateTime	String	2020-08-07	激活日期（卡片开始使用/计费时间）
	packageTime	String	2021-07-31	到期日期（卡片可使用到的日期，使用到最后一个月需要提前续费，给月底销户处理留出处理时间）
	remark	String	test	卡备注信息
	realNameStatus	String	1	实名状态：0 未实名， 1 已实名， 2 未知
	channelId	String	71	通道号，卡所属通道
	packageId	String	596	资费包id
	networkType	String	4G	网络制式