一卡通历史流水信息

最近更新时间: 2023年06月26日 05时38分49秒

数据中心

描述

根据学工号、数据时间查询人员一卡通历史流水信息

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

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

数据来源

一卡通系统

请求参数

参数名	是否必填	备注
userId	是	学工号
tradeStartTime	否	消费时间-开始时间
tradeEndTime	否	消费时间-结束时间

返回参数

参数名	类型	备注
fromAccount	STRING	物理卡号
userId	STRING	学工号
name	STRING	姓名
sexCode	STRING	性别代码
tradeDateTime	STRING	交易时间（年月日时分秒）
tradeDate	STRING	交易日期（年月日）
tradeTime	STRING	交易时间段（时分秒）
tradeMonth	STRING	交易月份（月）
tradeAmount	STRING	交易金额
cardBalance	STRING	卡内余额
mercName	STRING	商铺名称
restaurantName	STRING	所属食堂
campusAreaName	STRING	所属校区
mercTypeName	STRING	商铺类别
personTypeCode	STRING	人员类别代码
tranCode	STRING	时间代码
posCode	STRING	POS号

解释说明

count为请求返回值的数量，即查询范围内消费总次数； userInfos为返回参数，即查询范围内消费的详细信息。 tradeStartTime、tradeEndTime为传入参数，可全部为空，默认查询近一个月内历史消费情况，只传入tradeStartTime，则查询tradeStartTime到当前内的消费情况；只传入tradeEndTime，则查询全部数据截止到tradeEndTime范围内的数据。

请求示例


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

返回示例


{
  "code": "A00000",
  "data": {
    "count": 2,
    "userInfos": [
      {
        "campusAreaName": "四平校区",
        "cardBalance": 146.15,
        "fromAccount": "2*****7",
        "mercName": "四平校区学苑饮食广场中点部",
        "mercTypeName": "餐饮",
        "name": "邹**",
        "personTypeCode": "02",
        "posCode": 2,
        "restaurantName": "四平校区学苑广场",
        "sexCode": "2",
        "tradeAmount": 8.5,
        "tradeDate": "2022-07-23",
        "tradeDateTime": "2022-07-23 08:55:56",
        "tradeMonth": "07",
        "tradeTime": "08:30",
        "tranCode": "15",
        "userId": "1*****4"
      },
      {
        "campusAreaName": "四平校区",
        "cardBalance": 154.65,
        "fromAccount": "2*****7",
        "mercName": "四平校区西苑饮食广场快餐部",
        "mercTypeName": "餐饮",
        "name": "邹**",
        "personTypeCode": "02",
        "posCode": 15,
        "restaurantName": "四平校区西苑广场",
        "sexCode": "2",
        "tradeAmount": 5.52,
        "tradeDate": "2022-07-21",
        "tradeDateTime": "2022-07-21 11:47:37",
        "tradeMonth": "07",
        "tradeTime": "11:30",
        "tranCode": "15",
        "userId": "1*****4"
      }
    ]
  },
  "msg": "成功"
}