单日数据流量查询（批量）

接口功能

多个卡号码同时获取单日数据流量查询。

变更记录

接口版本

更新时间

更新人

更新说明

1.0.0

2023-06-17

邓双玲

新增单日数据流量查询（批量）

接口原型

请求类型

POST

请求地址

https://api.tibiot.com/api/v1/card/batchNewIotData

传输协议

HTTP

Content-Type

application/json

接口说明

1、只能查询一天前的日流量；
2、只能查询近30天的日流量数据；
3、一次最多1000个。

请求参数

参数

是否必填

类型

示例

描述

userName

是

String

zhangsan

用户名

passWord

是

String

123456

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

tKey

是

String

20190625143828

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

iccids

是

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

String

89860412101871055784,89860412101871055794,

所查询的iccid列表，多个iccid之间通过“,”分隔；

msisdns

String

1440533596137,1440533596139,

所查询的msisdn列表，多个msisdn之间通过“,”分隔

queryTime

是

String

2023-06-19

查询时间

flowUnit

否

String

MB

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

请求示例

1
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
{
    "userName":"zhangsan",
    "passWord":"e10adc3949ba59abbe56e057f20f883e",
    "tKey":"20190625143828",
    "msisdns":"1440533596137,1440533596139,",
    "queryTime":"2023-06-19"
}

响应示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

成功：

{
    "status":0,
    "message":"成功",
    "data":[
        {
            "syncStatus":1,
            "cardFlow":"140MB",
            "createTime":"2018-12-14",
            "syncTime":"2018-12-14 11:20:36",
            "iccid":"198604221519C0010010",
            "msisdn":"1440533596137"
        },
        {
            "syncStatus":1,
            "cardFlow":"140MB",
            "createTime":"2018-12-14",
            "syncTime":"2018-12-14 11:20:36",
            "iccid":"198604221519C0010035",
            "msisdn":"1440533596139"
        }
    ]
}

失败：

{
    "status":10001,
    "message":"用户名错误",
    "data":null
}
1
2
1
2
1
2
1
2
1
2
1
2

响应参数

参数

类型

示例

描述

status

int

0

返回状态

message

String

成功

返回信息

data

iccid

String

898606182182822224

iccid（19、20）位

msisdn

String

1064878381980

卡号（11 - 15）位

syncStatus

String

2

数据同步状态

1、未同步

2、已同步

cardFlow

String

140MB

卡流量

createTime

String

2018-12-14

数据生成日期

syncTime

String

2018-12-14 11:20:36

数据最后同步日期