一卡通账户信息

最近更新时间: 2024年12月18日 02时17分15秒

数据中心

描述

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

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

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

数据来源

一卡通系统

请求参数

参数名	是否必填	备注
userId	否	学工号可传入多个学工号(上限为500，使用英文逗号分割)进行批量查询
identity	否	证件号
sinceCradld	否	游标的起始位置，请把响应中的同字段传入，获取下一页，循环往复获取全量数据

返回参数

参数名	类型	备注
userId	STRING	学工号
name	STRING	姓名
deptCode	STRING	单位代码
deptName	STRING	单位
cardId	STRING	卡号，（包含物理卡号和虚拟卡号）

解释说明

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

请求示例


curl -X GET \
  'https://api.tongji.edu.cn/v1/dc/card/account' \
  -H 'userId: ' \
  -H 'identity: ' \
  -H 'sinceCradld: '

返回示例


{
  "code": "A00000",
  "data": {
    "count": 2,
    "sinceCardId": "3*******5",
    "userInfos": [
      {
        "cardId": "3******5",
        "deptCode": "004960",
        "deptName": "电子与信息工程学院",
        "name": "沈*",
        "userId": "2******7"
      },
      {
        "cardId": "1******4",
        "deptCode": "004960",
        "deptName": "电子与信息工程学院",
        "name": "沈*",
        "userId": "2****7"
      }
    ]
  },
  "msg": "成功"
}