一卡通历史流水信息

最近更新时间: 2025年12月19日 09时52分04秒

数据中心

描述

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

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

数据来源

SYS20230100(一卡通系统)

请求参数

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

返回参数

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

解释说明

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

请求示例


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

返回示例


{  "code": "A00000",
  "data": {
    "count": 5,
    "userInfos": [
      {
        "campusAreaName": "四平校区",
        "cardBalance": 184.45,
        "fromAccount": 342668,
        "mercName": "四平路校区西北超市",        "mercTypeName": "超市与店铺",
        "name": "*****",
        "personTypeCode": "派遣人员",
        "posCode": 9,
        "restaurantName": "无",
        "sexCode": "1",
        "tradeAmount": 4.5,
        "tradeDate": "2025-05-28",
        "tradeDateTime": "2025-05-28 14:03:36",        "tradeMonth": "05",
        "tradeTime": "14:00",
        "tranCode": "15",
        "userId": "*********"
      }    ]
  },  "msg": "成功"
}