人员整合信息

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

数据中心

批量

描述

根据人员唯一编号pid查询人员所有学工号基本信息

支持的模式

客户端模式

请求方法

GET

请求地址

https://api.tongji.edu.cn/v2/dc/user/person_info_by_pid

数据来源

人事系统,教务系统,人员状态系统

请求参数

参数名	是否必填	备注
pid	否	人员唯一编号
sincePid	否	游标的起始位置，请把响应中的同字段传入，获取下一页，循环往复获取全量数据
sinceUpdateTime	否	更新时间，获取该时间点之后信息有更改的数据，此字段格式支持YYYY-MM-DD HH:mm:ss 和 unix时间戳

返回参数

参数名	类型	备注	码表
userId	STRING	学号
name	STRING	姓名
deptCode	string	部门/学院代码
deptName	string	部门/学院名称
userTypeCode	STRING	人员类型代码	types
userTypeName	STRING	人员类型名称
statusCode	string	人员身份认证状态
statusName	string	人员身份认证状态名称
pid	string	人员唯一编号

解释说明

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

请求示例


curl -X GET \
  'https://api.tongji.edu.cn/v2/dc/user/person_info_by_pid' \
  -H 'pid: ' \
  -H 'sincePid: ' \
  -H 'sinceUpdateTime: '

返回示例


{
  "code": "A00000",
  "data": {
    "count": 2,
    "userInfos": [
      {
        "deptCode": "000054",
        "deptName": "教育技术与计算中心",
        "name": "邹**",
        "pid": "1******8",
        "statusCode": "1",
        "statusName": "无效",
        "userId": "1*****1",
        "userTypeCode": "1",
        "userTypeName": "教职工"
      },
      {
        "deptCode": "000054",
        "deptName": "教育技术与计算中心",
        "name": "邹**",
        "pid": "1******8",
        "statusCode": "0",
        "statusName": "有效",
        "userId": "1*****4",
        "userTypeCode": "1",
        "userTypeName": "教职工"
      }
    ],
    "sincePid": "1*****8"
  },
  "msg": "成功"
}