单条/全量/增量/新增人员基本信息-实时

最近更新时间: 2025年09月25日 06时51分34秒

实时

描述

根据人员身份认证状态、部门和人员类型等查询人员基本信息

支持的模式

客户端模式

请求方法

GET

请求地址

https://api.tongji.edu.cn/v2/rt/user/all_info

数据来源

人员状态系统

请求参数

参数名	是否必填	备注
statusCode	否	人员身份认证状态，0代表有效、1代表失效、-1代表全部不传参数默认为0
deptCode	否	部门/学院代码不传代表全部获取
userTypeCode	否	人员类型，1-教职工、2-本科生、3-硕士研究生、4-博士研究生、5-继续教育本科、6-继续教育外聘教师、7-供应商人员，不传代表全部获取
sinceUserId	否	游标的起始位置，请把响应中的同字段传入，获取下一页，循环往复获取全量数据
sinceCreateTime	否	创建时间，timestamp，seconds，获取该时间点之后生成的用户基本信息，请注意保证此参数在同一次增量拉取时不会变化
sinceUpdateTime	否	更新时间，timestamp，seconds，获取该时间点之后信息有更改的用户基本信息，请注意保证此参数在同一次增量拉取时不会变化
userId	否	学工号，最多每次传1000个，用英文逗号隔开

返回参数

参数名	类型	备注	码表
userId	string	学工号
name	string	姓名
deptCode	string	部门/学院代码
deptName	string	部门/代码名称
userTypeCode	string	人员类型代码	types
userTypeName	string	人员类型名称
statusCode	string	状态，全部取自人员状态	status
statusName	string	状态名称
createTime	date	创建时间
updateTime	date	更新时间

解释说明

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

请求示例


curl -X GET \
  'https://api.tongji.edu.cn/v2/rt/user/all_info?statusCode=&deptCode=&userTypeCode=&sinceUserId=&sinceCreateTime=&sinceUpdateTime=&userId='

返回示例


{
  "code": "A00000",
  "data": {
    "count": 2,
    "sinceUserId": "21*****7",
    "userInfos": [
      {
        "createTime": "2023-11-06 11:33:53",
        "deptCode": "000033",
        "deptName": "继续教育学院",
        "name": "姚*",
        "statusCode": "0",
        "statusName": "有效",
        "updateTime": "2024-06-26 16:09:48",
        "userId": "21*****7",
        "userTypeCode": "5",
        "userTypeName": "继续教育本科"
      },
      {
        "createTime": "2023-11-06 11:33:30",
        "deptCode": "000033",
        "deptName": "继续教育学院",
        "name": "雷**",
        "statusCode": "0",
        "statusName": "有效",
        "updateTime": "2024-06-26 16:09:46",
        "userId": "21*****6",
        "userTypeCode": "5",
        "userTypeName": "继续教育本科"
      }
    ]
  }
}