Get User Base Info¶

根据用户邮箱、账号和域、或电话号码和电话区号获取用户的基本信息如用户 ID 等。

操作权限¶

需要在 EnOS 应用门户给应用授权“获取本 OU 内所有用户 ID、账号、邮箱、手机号码”的权限。

请求格式¶

POST https://{apigw-address}/app-portal-service/v2.2/user/getUserBaseInfo

请求参数（Body）¶

名称	必需/可选	数据类型	描述
organizationId	必需	String	组织 ID。如何获取 organizationId 信息>>
email	可选	String	用户邮箱
name	可选	String	用户名如用户为域账号，需同 domain 参数一同使用
domain	可选	String	域名称无法单独作为查询条件，须同 name 参数一起使用
phoneArea	可选	String	电话区号无法单独作为查询条件，须同 phone 一起使用
phone	可选	String	电话号码无法单独作为查询条件，须同 phoneArea 一起使用

响应参数¶

名称	数据类型	描述
data	SimpleUserListDTO 结构体	用户基本信息的列表

SimpleUserListDTO 结构体¶

名称	数据类型	描述
users	List<SimpleUserDTO>	用户基本信息的列表

SimpleUserDTO 结构体¶

名称	数据类型	描述
id	String	用户 ID
name	String	用户名
domain	String	用户所属域
email	String	用户邮箱
department	String	用户所属的部门
company	String	用户所属的公司
position	String	用户的职位
updatedTime	String	用户的更新时间

错误码¶

代码	描述
31400	参数错误，参数不能为空等
31403	应用未被授权“获取本 OU 内所有用户 ID、账号、邮箱、手机号码”的权限
31404	未找到组织、用户等

示例¶

请求示例¶

url: https://{apigw-address}/app-portal-service/v2.2/user/getUserBaseInfo

method: POST

requestBody:
{"organizationId":"yourOrgId", "email":"yourEmail"}

返回示例¶

{
  "code": 0,
  "message": "OK",
  "data": {
    "users": [
      {
        "id": "your_user_id",
        "name": "your_user_name",
        "domain": "",
        "email": "your_user_email",
        "company": "your_user_company",
        "position": "your_user_position",
        "department": "your_user_department"
      }
    ]
  }
}