一卡通账户信息

最近更新时间: 2026年01月15日 07时52分24秒

数据中心

批量

描述

根据学工号或证件号查询人员一卡通账户信息

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

数据来源

SYS20230100(一卡通系统)

请求参数

参数名	是否必填	备注
userId	否	学工号，可传入多个学工号，最多1000条
cardNo	否	证件号
sinceld	否	游标的起始位置，请把响应中的同字段传入，获取下一页，循环往复获取全量数据
sinceUpdateTime	否	更新时间，获取该时间点之后信息有更改的数据，此字段格式支持YYYY-MM-DD HH:mm:ss 和 unix时间戳

返回参数

参数名	类型	备注
userId	string	学工号
name	string	姓名
deptCode	string	单位代码
deptName	string	单位
campusCardId	string	校园卡卡号，（包含校园卡物理卡号和NFC卡号）
cardStatus	string	卡状态名称
cardTypeName	string	卡类型：包括校园卡，NFC两种
cardStatusCode		卡状态

解释说明

每次固定返回1000条数据第一次请求sinceld请置为空获取后续数据在请求上附上上一次的sinceld 当sinceld为空或者返回条数为0时,可以停止循环，已经获取全量数据;

请求示例


curl -X GET \
  'https://api.tongji.edu.cn/v2/dc/card/account?userId=&cardNo=&sinceld=&sinceUpdateTime='

返回示例


{
  "code": "A00000",
  "data": {
    "count": 1,
    "list": [
      {
        "campusCardId": "**********",
        "cardNo": "****************",
        "cardStatus": "卡启用",
        "cardStatusCode": "1",
        "cardTypeName": "校园卡",
        "deptCode": "******",
        "deptName": "教育技术与计算中心",
        "id": "******",
        "name": "******",
        "updateTime": "2026-01-14T00:00:00",
        "userId": "*****"
      }
    ],
    "sinceId": "******"
  },
  "msg": "操作成功"
}