用户查询

  • 接口：common/users/v2/findByUsername
  • Method：GET
  • 接口说明：根据用户名查询用户信息
  • 多语言环境：实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种

请求参数

字段名称 字段类型 字段描述 是否必填 长度
bizId String 业务唯一识别码 true 255
timestamp long 时间戳 true 无
user_name String 用户名 true 64

请求示例

/common/users/v2/findByUsername?user_name=kevinchen718@hotmail.com&bizId=7171d721-1d60-447c-930f-787eb64781ab&timestamp=1654499450621

返回参数

默认返参

字段名称 字段类型 字段描述
resCode Integer 状态码
resMsg String 描述
data.code String 编码（ 即员工号）
data.full_name String 全名
data.email_address String 邮箱
data.user_name String 用户名
data.mobile String 手机
data.gender String 性别
data.department.code Array 部门编码
data.department.department_name String 部门名称
data.cost_center.code String 默认成本中心编码
data.cost_center.department_name String 默认成本中心名称
data.parent.code String 上级编码（ 即员工号）
data.parent.user_name String 上级用户名
data.parent.full_name String 上级姓名
data.approval_level String 审批层数
data.inactive_date long 失效时间
####可配置返参
字段名称 字段类型 字段描述
:----------------------------- :------- :-----------
data.full_name String 全名
data.user_name String 用户名
data.surname String 姓
data.given_name String 名
data.email_address String 邮箱
data.mobile String 手机号
data.description String 描述
data.dingtalk_name String 钉钉号
data.dingtalk_unionid String 钉钉unionid
data.feishu_name String 飞书号
data.wechatqy_name String 企业微信号
data.sub_company String 子公司
data.inactive_date date 失效日期
data.parent.* JSONObject 关联上级字段，相关表为fnd_user
data.approval_level int 审批级别
data.gender string 性别
data.employee_number string 员工号
data.base_city int 所在城市
data.birthday date 生日
data.profession string 职业
data.nationality string 国籍
data.telephone string 电话
data.address string 地址
data.postcode string 邮政编码
data.department.* JSONObject 关联的部门信息，相关表fnd_department
data.cost_center.* JSONObject 关联的部门信息，相关表fnd_department
data.branch.* JSONObject 关联的部门信息，相关表fnd_department
data.position.* JSONObject 关联的部门信息，fnd_position
data.level.* JSONObject 关联的部门信息，fnd_level
data.date_of_joining date 入职日期
data.resignation_date date 离职日期
data.start_work_date date 开始工作时间
data.default_language String 默认语言
data.sub_account_name String 子账号名称
data.credit_score int 信用分
data.credit_level int 信用等级
data.point_balance decimal 积分余额
data.point_frozen decimal 积分冻结
data.column1-column50 string column字段对应的名称
data.attribute1-attribute5 string attribute字段对应的名称
data.creation_date date 创建日期
data.last_update_date date 最后更新日期

返回示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "7171d721-1d60-447c-930f-787eb64781ab",
  "data": [
    {
      "code": "kevinchen718@hotmail.com",
      "gender": "M",
      "parentVo": {
        "code": "34554236576542725",
        "full_name": "李四",
        "employee_number": "34554236576542725",
        "user_name": "123@23.com"
      },
      "departmentVo": {
        "code": "D1",
        "department_name": "Tiny Ship",
        "department_code": "D1"
      },
      "costCenterVo": {
        "code": "D010",
        "department_name": "方外人事有限公司",
        "department_code": "D010"
      },
      "email_address": "kevinchen718@hotmail.com",
      "full_name": "李四",
      "employee_number": "kevinchen718@hotmail.com",
      "user_name": "kevinchen718@hotmail.com",
      "approval_level": 1
    }
  ]
}

results matching ""

    No results matching ""