文档

GetOrganizationMember - 查询企业成员信息

更新时间:

根据指定条件获取企业成员信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /organization/{organizationId}/members/{accountId}

请求参数

名称类型必填描述示例值
organizationIdstring

企业标识,也称企业 id

66c0c9fffeb86b450c199fcd
accountIdstring

阿里云用户 UID

123456677888

返回参数

名称类型描述示例值
object

Schema of Response

requestIdstring

请求 id,每次请求都是唯一值,便于后续排查问题

HC93CE1A-8D7A-13A9-8306-7465DE2E5C0F
errorMessagestring

错误信息

error info
memberobject

成员

accountIdstring

阿里云用户 UID

123456677888
birthdaylong

生日

1631845101798
deptListsarray

部门名称列表

string

部门名称

测试部门
emailstring

邮箱

123@mail.com
hiredDatelong

入职时间

1631845101798
identitiesobject

第三方信息

externUidstring

第三方系统的用户 id

1236666
providerstring

第三方系统

Dingtalk
joinTimelong

加入云效企业时间

1631845101798
lastVisitTimelong

最近一次访问时间

1631845101798
mobilestring

手机号

1390000****
organizationMemberNamestring

企业成员名

名字1
organizationRoleNamestring

企业角色名字

管理员
jobNumberstring

工号

373***
organizationRoleIdstring

企业角色 Id

8fc0c9ff039711dd64acd000
statestring

用户状态(正常(normal),已停用(blocked),已删除(deleted))

normal
errorCodestring

错误码

null
successboolean

true 接口调用成功,false 接口调用失败

true

示例

正常返回示例

JSON格式

{
  "requestId": "HC93CE1A-8D7A-13A9-8306-7465DE2E5C0F",
  "errorMessage": "error info",
  "member": {
    "accountId": "123456677888",
    "birthday": 1631845101798,
    "deptLists": [
      "测试部门"
    ],
    "email": "123@mail.com",
    "hiredDate": 1631845101798,
    "identities": {
      "externUid": "1236666",
      "provider": "Dingtalk"
    },
    "joinTime": 1631845101798,
    "lastVisitTime": 1631845101798,
    "mobile": "1390000****",
    "organizationMemberName": "名字1",
    "organizationRoleName": "管理员",
    "jobNumber": "373***",
    "organizationRoleId": "8fc0c9ff039711dd64acd000",
    "state": "normal"
  },
  "errorCode": "null",
  "success": true
}

错误码

HTTP status code错误码错误信息描述
400InvalidUser.UserNotInCurrentOrganizationThe user is not in the organization.当前用户不在该企业中
403Forbidden.UserNotAdminOrOwnerThe current user is not an admin or owner in the organization and is not authorized to perform the operation.当前用户非该企业管理员或拥有者,无权进行操作。
404InvalidOrganization.NotFoundThe organization is not found.企业不存在,请检查企业ID是否正确

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-11-27OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2021-09-22新增 OpenAPI查看变更详情