人员家庭信息

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

数据中心

批量

描述

根据学工号查询在校人员家庭信息

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

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

数据来源

教务系统,人事系统,学工系统

请求参数

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

返回参数

参数名	类型	备注	码表
userId	STRING	学工号
name	STRING	姓名
userTypeCode	STRING	人员类型代码	types
userTypeName	STRING	人员类型名称
deptCode	STRING	部门/学院代码
deptName	STRING	部门/学院名称
homeAddress	STRING	家庭住址
mailAddress	STRING	通信地址
domicilePlace	STRING	户口所在地
postalCode	STRING	有效邮政编码

解释说明

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

请求示例


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

返回示例


{
  "code": "A00000",
  "data": [
    {
      "deptCode": "0***8",
      "deptName": "生********院",
      "domicilePlace": "甘*******关",
      "homeAddress": " ",
      "mailAddress": "上************号",
      "name": "张*",
      "postalCode": "2*****2",
      "userId": "1*******9",
      "usertypeCode": "4",
      "usertypeName": "博士研究生"
    }
  ],
  "msg": "成功"
}