人员同步
接口:/common/thirdparty/syn/users
Method:POST
数据格式:JSON
接口说明:同步人员信息到第三方平台
请求参数
字段 | 类型 | 释义 | 是否必填 |
---|---|---|---|
platform | String | 渠道(url参数) | Y |
userSynBatchVo | UserSynBatchVo | 请求数据体(请求体) | Y |
UserSynBatchVo
字段 | 类型 | 释义 | 是否必填 |
---|---|---|---|
userInfos | List |
人员数据 | Y |
config | JSONObject | 配置 | N |
UserSynBatchVo
字段 | 类型 | 释义 | 是否必填 |
---|---|---|---|
userId | Integer | 用户ID | N |
companyId | Integer | 公司ID | N |
userName | String | 用户名 | N |
fullName | String | 用户的完整姓名 | N |
surName | String | 姓氏 | N |
givenName | String | 名字 | N |
baseCity | Integer | 基础城市ID | N |
supervisorId | Integer | 上级ID | N |
employeeNumber | String | 员工编号 | NN |
String | 电子邮件 | N | |
gender | String | 性别 | N |
mobile | String | 手机号 | N |
nationality | String | 国籍 | N |
birthday | Date | 出生日期 | N |
inactiveDate | Date | 注销日期 | N |
enabledFlag | String | 启用标志 | N |
wechatqyName | String | 企业微信名 | N |
dingtalkName | String | 钉钉名 | N |
feishuName | String | 飞书名 | N |
resignationDate | Date | 离职日期 | N |
departmentId | Integer | 部门ID | N |
departmentName | String | 部门名称 | N |
departmentCode | String | 部门编码 | N |
costCenterId | Integer | 成本中心ID | N |
costCenterName | String | 成本中心名称 | N |
costCenterCode | String | 成本中心编码 | N |
branchId | Integer | 分公司ID | N |
branchName | String | 分公司名称 | N |
branchCode | String | 分公司编码 | N |
levelId | String | 职级ID | N |
levelName | String | 职级名称 | N |
levelCode | String | 职级编码 | N |
groupCode | String | 团队编码 | N |
groupName | String | 团队名称 | N |
/common/thirdparty/syn/users?platform=ctrip
{
"userInfos": [
{
"userId": 111,
"companyId": 123,
"userName": "john_doe",
"fullName": "John Doe",
"surName": "Doe",
"givenName": "John",
"baseCity": 101,
"supervisorId": 555,
"employeeNumber": "E5678",
"email": "john.doe@example.com",
"gender": "Male",
"mobile": "+1234567890",
"nationality": "USA",
"birthday": "1985-08-15",
"inactiveDate": "2024-12-31",
"enabledFlag": "Y",
"wechatqyName": "john_doe_wechat",
"dingtalkName": "john_doe_dingtalk",
"feishuName": "john_doe_feishu",
"resignationDate": "2025-01-01",
"departmentId": 10,
"departmentName": "Engineering",
"departmentCode": "ENG001",
"costCenterId": 500,
"costCenterName": "R&D",
"costCenterCode": "CC100",
"branchId": 1,
"branchName": "New York Branch",
"branchCode": "NY001",
"levelId": "L2",
"levelName": "Senior Engineer",
"levelCode": "SE2",
"groupCode": "G1",
"groupName": "Tech Team"
}
]
}
响应参数
字段名称 | 字段类型 | 字段描述 |
---|---|---|
resCode | String | 状态码 |
resMsg | String | 描述 |
响应示例
{
"resCode": 200000,
"resMsg": "success"
}