一卡通历史流水汇总信息

描述

此接口为通用接口，可根据传入的cycle类型，进行时间间隔、近n周、近n月，查询对应用户的一卡通消费流水汇总信息

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

https://api.tongji.edu.cn/v1/dc/card/week_or_month_sum 

数据来源

一卡通系统

请求参数

返回参数

解释说明

1 cycle为统计周期类型，分别为week（周）、month（月）、date（日期）。 2 传入week与month时，周期n为必传，即可统计最近n周/月，每个自然周/月的一卡通消费汇总情况； 2.1 第1周(月)即为当前周(月)，第2周(月)即为上一周(月)，依次类推。 3 传入date，周期n不传，需要传入消费开始时间与结束时间。 3.1 tradeStartTime和tradeEndTime不传值时，默认计算这个人最近1个月的消费总额； 3.2 tradeStartTime传值且tradeEndTime不传值时，计算交易时间在tradeStartTime到tradeStartTime+30时间段内的消费总额； 3.3 tradeStartTime不传值且tradeEndTime传值时，计算交易时间在tradeEndTime-30到tradeEndTime时间段内的消费总额； 3.4 tradeStartTime和tradeEndTime都传值时，计算tradeStartTime和tradeEndTime时间段内的消费总额，n是否传值都不影响。

请求示例

curl -X GET \
  'https://api.tongji.edu.cn/v1/dc/card/week_or_month_sum' \
  -H 'userId: ' \
  -H 'cycle: ' \
  -H 'tradeStartTime: ' \
  -H 'tradeEndTime: ' \
  -H 'n: ' 

返回示例

**类型为date，某一时间段内消费总额**
{
    "code": "A00000",
    "data": [
        {
            "last": 1,
            "note": "2022-08-23 10:00:00到2022-09-23 10:00:00的消费总额",
            "tradeAmt": 164.86
        }
    ],
    "msg": "成功"
}