卡历史月用量查询

典型场景

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

接口功能

查询近3个月的卡套餐用量查询，当前月不包含在内

变更记录

接口版本	更新时间	更新人	更新说明
1.0.0	2022-01-12	邓双玲	新增卡历史月用量查询

接口原型

请求类型	POST
请求地址	https://api.tibiot.com/api/v1/card/queryCardMonthData
传输协议	HTTP
Content-Type	application/json
接口说明	卡号、iccid必须传一个

请求参数

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

请求示例

响应示例

{
                            "status": 0,
                            "message": "成功",
                            "data": [
                                {
                                    "years": "2024-11",
                                    "cardFlow": "320KB",
                                    "iccid": "898604B9122380048027",
                                    "msisdn": "3440090403687",
                                    "syncTime": "2024-12-04 19:49:49"
                                },
                                {
                                    "years": "2024-10",
                                    "cardFlow": "288KB",
                                    "iccid": "898604B9122380048027",
                                    "msisdn": "3440090403687",
                                    "syncTime": "2024-11-04 21:24:05"
                                },
                                {
                                    "years": "2024-09",
                                    "cardFlow": "320KB",
                                    "iccid": "898604B9122380048027",
                                    "msisdn": "3440090403687",
                                    "syncTime": "2024-10-05 06:53:39"
                                }
                            ]
                        }

成功：

失败：

响应参数

参数		类型	示例	描述
status		int	0	返回状态，0成功，非0失败
message		String	成功	返回信息，失败为失败说明
data	years	String	2024-12	时间格式（yyyy-MM）
	iccid	String	898604B9122380048027	iccid
	msisdn	String	3440090403687	卡号
	cardFlow	String	320KB	已使用流量
	syncTime	String	2024-12-03 11:23:33	流量同步时间