人员证件信息

最近更新时间: 2025年05月30日 08时30分30秒

数据中心

批量

描述

根据学工号查询人员证件号码信息

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

https://api.tongji.edu.cn/v2/dc/sep_auth/card_no_info

数据来源

教务系统,人事系统

请求参数

参数名	是否必填	备注
userId	是	学工号，可传入多个学工号（上限为500，使用英文逗号分割）进行批量查询
sinceUserId	否	游标的起始位置，请把响应中的同字段传入，获取下一页，循环往复获取全量数据
sinceUpdateTime	否	更新时间，获取该时间点之后信息有更改的数据，此字段格式支持YYYY-MM-DD HH:mm:ss 和 unix时间戳

返回参数

参数名	类型	备注	码表
msg	string
code	string
data	object[object]
count	float
list	array[object]
updateTime	string	更新时间
cardNo	string	证件号码，来源于各个系统
userId	string	学工号
cardCode	string	证件类型	types
cardType	string	证件类型名称
sinceUserId	string

解释说明

此接口可入参学号单条获取人员证件信息。如需不传参批量获取数据，请看以下说明：初始化获取全量数据：首次请求无需传参，每次固定返回1000条数据，获取后续数据在请求上附上上一次的sinceUserId，当sinceUserId为空或者返回条数为0时,可以停止循环，已经获取全量数据。获取增量数据：入参为sinceUpdateTime，获取该时间点之后有更改的数据。更新时间：数据来源于教务系统本科生、研究生基本信息表和人事系统的人员基本信息表，更新时间会根据基本信息表中任意字段值的变更而同步更新，而不仅仅局限于接口所涉及的字段值。

请求示例


curl -X GET \
  'https://api.tongji.edu.cn/v2/dc/sep_auth/card_no_info?userId=&sinceUserId=&sinceUpdateTime='

返回示例


{
    "data":[
        {
            "userId":"20***4",
            "cardNo":"131******09",
            "cardCode":"01",
            "updateTime": "2025-05-19T00:00:00",
            "cardType":"居民身份证"
        }
    ],
    "code":"A00000",
    "msg":"成功"
}