多张卡信息查询

典型场景

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

接口功能

最多组织100张卡批量查询卡信息接口

变更记录

接口版本

更新时间

更新人

更新说明

1.0.0

2021-09-22

邓双玲

新增多张卡信息查询接口

1.0.1

2023-01-28

邓双玲

响应参数新增channelId、packageId

1.0.2

2023-02-15

邓双玲

响应参数新增imsi

1.0.3

2023-04-12

邓双玲

请求参数删除cardType;响应参数新增cardType

1.0.4

2023-11-29

邓双玲

请求参数新增beginPackageTime、endPackageTime、cardStatus;响应参数新增imei

1.0.5

2023-12-29

邓双玲

响应参数新增buyTime

接口原型

请求类型

POST

请求地址

https://api.tibiot.cn/api/v1/card/moreQueryCardInfo

传输协议

HTTP

Content-Type

application/json

接口说明

卡信息多张卡查询,此接口组装信息较多,不支持并发请求,最多100号码

请求参数

参数

是否必填

类型

示例

描述

userName

String

zhangsan

用户名

passWord

String

123456

加密后密码,加密规则参照密码加密规则

tKey

String

20190625143828

当前时间,tKey生成规则参照tKey规则

iccids

注:iccids与msisdns有且只能有一个

String

89860412101871055784,89860412101871055794,

最多提交100个,以英文逗号连接和结尾

msisdns

String

1440533596137,1440533596139,

flowUnit

String

MB

根据传值设定响应值(总流量、已使用量 、剩余流量)的单位,支持传值:KB MB GB TB PB EB,不传系统将按流量大小自动转换单位

beginPackageTime

String

2023-11-01

卡到期日期开始查询时间

endPackageTime

String

2023-11-30

卡到期日期开始结束时间

cardStatus

int

1

卡状态:1.正常 2.停机 3.沉默期 5.测试期 6.停机保号

请求示例

响应示例

成功:

失败:

响应参数

参数

类型

示例

描述

status

int

0

返回状态

message

String

成功

返回信息

data

iccid

String

898607B5041700064496

iccid

msisdn

String

6408698556983

卡号

imsi

String

852633001536365

imsi

imei

String

852633001536365

imei

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

cardType

int

1

卡类型:1单卡 2池卡 3销户

dismantleTime

String

2023-05-11 16:57:16

销户时间

orderId

String

202308021613455689

购卡订单ID

buyTime

int

12

购买时长,套餐不变情况下时长累计,套餐变化时长重置