根据卡号获取学工号

最近更新时间: 2023年12月07日 06时08分06秒

实时

描述

本文档说明了如何根据一卡通的卡号（包含物理卡号和虚拟卡号）（cardId）获取相应的学工号（userId）。卡号是每张一卡通的独特标识，即通过读卡器读取的信息。

支持的模式

客户端模式

请求方法

GET

请求地址

https://api.tongji.edu.cn/v1/rt/card/userid_by_cardid

数据来源

一卡通系统

请求参数

参数名	是否必填	备注
cardId	是	卡ID号,可传入多个卡ID号（上限为200，使用英文逗号分割）进行批量查询

返回参数

参数名	类型	备注	码表
userId	STRING	学工号
cardId	STRING	卡ID号

请求示例


curl -X GET \
  'https://api.tongji.edu.cn/v1/rt/card/userid_by_cardid?cardId='

返回示例


{
  "code": "A00000",
  "data": {
    "count": 2,
    "userInfos": [
      {
        "cardId": "6*****4",
        "userId": "2*****1"
      },
      {
        "cardId": "1*****9",
        "userId": "2*****4"
      }
    ]
  },
  "msg": "成功"
}