人员证件信息

最近更新时间: 2025年05月08日 02时16分44秒

数据中心

批量

描述

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

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

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

数据来源

教务系统,人事系统

请求参数

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

返回参数

参数名	类型	备注	码表
userId	STRING	学工号
cardNo	STRING	证件号码，来源于各个系统
cardCode	STRING	证件类型	types
cardType	STRING	证件类型名称

解释说明

此接口可入参学号单条获取人员证件信息。如需不传参批量获取数据，请看以下说明：初始化获取全量数据：首次请求无需传参，每次固定返回1000条数据，获取后续数据在请求上附上上一次的sinceUserId，当sinceUserId为空或者返回条数为0时,可以停止循环，已经获取全量数据。获取增量数据：入参为sinceUpdateTime，获取该时间点之后有更改的数据。

请求示例


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

返回示例


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