根据指定条件获取企业成员信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /organization/{organizationId}/members/{accountId} HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| organizationId |
string |
是 |
企业标识,也称企业 id |
66c0c9fffeb86b450c199fcd |
| accountId |
string |
是 |
阿里云用户 UID |
123456677888 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
当前API无需请求参数
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求 id,每次请求都是唯一值,便于后续排查问题 |
HC93CE1A-8D7A-13A9-8306-7465DE2E5C0F |
| errorMessage |
string |
错误信息 |
error info |
| member |
object |
成员 |
|
| accountId |
string |
阿里云用户 UID |
123456677888 |
| birthday |
integer |
生日 |
1631845101798 |
| deptLists |
array |
部门名称列表 |
|
|
string |
部门名称 |
测试部门 |
|
|
string |
邮箱 |
123@mail.com |
|
| hiredDate |
integer |
入职时间,使用 Unix 时间戳,单位为毫秒。 |
1631845101798 |
| identities |
object |
第三方信息 |
|
| externUid |
string |
第三方系统的用户 id |
1236666 |
| provider |
string |
第三方系统 |
Dingtalk |
| joinTime |
integer |
加入云效企业时间,使用 Unix 时间戳,单位为毫秒。 |
1631845101798 |
| lastVisitTime |
integer |
最近一次访问时间,使用 Unix 时间戳,单位为毫秒。 |
1631845101798 |
| mobile |
string |
手机号 |
1390000**** |
| organizationMemberName |
string |
企业成员名 |
名字1 |
| organizationRoleName |
string |
企业角色名字 |
管理员 |
| jobNumber |
string |
工号 |
373*** |
| organizationRoleId |
string |
企业角色 Id |
8fc0c9ff039711dd64acd000 |
| state |
string |
用户状态(正常(normal),已停用(blocked),已删除(deleted)) |
normal |
| errorCode |
string |
错误码 |
null |
| success |
boolean |
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 |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidUser.UserNotInCurrentOrganization | The user is not in the organization. | 当前用户不在该企业中 |
| 403 | Forbidden.UserNotAdminOrOwner | The current user is not an admin or owner in the organization and is not authorized to perform the operation. | 当前用户非该企业管理员或拥有者,无权进行操作。 |
| 404 | InvalidOrganization.NotFound | The organization is not found. | 企业不存在,请检查企业ID是否正确 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。