# 获取关联组织成员详情

获取关联组织成员详情，需要对关联组织成员有权限才可以获取。

## 提示
使用 user_access_token 时，按照 admin 管理后台关联组织列表中针对用户设置的可见性规则进行校验，使用 tenant_access_token 时，按照应用互通界面中针对应用设置的可见性规则进行校验。

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/trust_party/v1/collaboration_tenants/:target_tenant_key/collaboration_users/:target_user_id
HTTP Method | GET
接口频率限制 | [5 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 以应用身份读取关联组织(trust_party:collaboration.tenant:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>或<br>`user_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)

### 路径参数

名称 | 类型 | 描述
---|---|---
target_tenant_key | string | 对方关联组织的tenant key，可通过[管理员获取所有关联组织列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/directory-v1/collaboration_tenant/list)获取<br>**示例值**："4e6ac4d14bcd5071a37a39de902c7141"
target_user_id | string | 请求的关联组织用户ID，需要与target_user_id_type中填写的类型保持一致<br>**示例值**："od-4e6ac4d14bcd5071a37a39de902c7141"

### 查询参数

名称 | 类型 | 必填 | 描述
---|---|---|---
target_user_id_type | string | 否 | 用户ID类型，可以在[获取关联组织的部门和成员信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/collaboration_tenant/visible_organization)中获取对应的用户ID<br>**示例值**：user_id<br>**可选值有**：<br>- user_id：以user_id来识别用户<br>- union_id：以union_id来识别用户<br>- open_id：以open_id来识别用户<br>**默认值**：`user_id`

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
target_user | collaboration_user | 关联组织用户
open_id | string | 对方关联组织用户的open_id
user_id | string | 对方关联组织用户的id
union_id | string | 对方关联组织用户的union id
name | string | 用户的名称
i18n_name | i18n_name | 关联组织的的国际化用户名称
zh_cn | string | 中文名
ja_jp | string | 日文名
en_us | string | 英文名
avatar | avatar_info | 用户头像信息
avatar_72 | string | 72*72像素头像链接
avatar_240 | string | 240*240像素头像链接
avatar_640 | string | 640*640像素头像链接
avatar_origin | string | 原始头像链接
mobile | string | 手机号,需要对方租户授权展示.
status | user_status | 用户状态
is_frozen | boolean | 是否冻结
is_resigned | boolean | 是否离职
is_activated | boolean | 是否激活
is_exited | boolean | 是否主动退出，主动退出一段时间后用户会自动转为已离职
is_unjoin | boolean | 是否未加入，需要用户自主确认才能加入团队
department_ids | string\[\] | 用户所属部门的ID列表,已废弃
leader_user_id | string | 用户的直接主管的用户ID,已废弃
job_title | string | 职务,需要对方租户授权展示.
custom_attrs | user_custom_attr\[\] | 自定义属性,需要对方租户授权展示.
type | string | 自定义属性类型
id | string | 自定义属性ID
value | user_custom_attr_value | 自定义属性取值
text | string | 属性文本
url | string | URL
pc_url | string | PC上的URL
option_value | string | 选项值
picture_url | string | 图片链接
name | string | 名称
generic_user | custom_attr_generic_user | 用户信息
id | string | 用户id
type | int | 用户类型，枚举值：<br>- 1: 用户 <br>- 2: 机器人<br>- 11: Mail
employee_no | string | 工号,需要对方租户授权展示
parent_department_ids | collaboration_department_id\[\] | 父部门ID，必须对父部门有权限才会返回
department_id | string | 部门ID
open_department_id | string | 部门open ID
leader_id | collaboration_user_id | 用户的leader，必须对leader有权限才会返回
user_id | string | 用户ID
open_id | string | 用户open ID
union_id | string | 用户union ID

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "target_user": {
            "open_id": "ou_4e6ac4d14bcd5071a37a39de902c7141",
            "user_id": "902c7141",
            "union_id": "on_cad4860e7af114fb4ff6c5d496d1dd76",
            "name": "test_name",
            "i18n_name": {
                "zh_cn": "zh_cn_name",
                "ja_jp": "ja_jp_name",
                "en_us": "en_name"
            },
            "avatar": {
                "avatar_72": "https://foo.icon.com/xxxx",
                "avatar_240": "https://foo.icon.com/xxxx",
                "avatar_640": "https://foo.icon.com/xxxx",
                "avatar_origin": "https://foo.icon.com/xxxx"
            },
            "mobile": "+41446681800",
            "status": {
                "is_frozen": false,
                "is_resigned": false,
                "is_activated": true,
                "is_exited": true,
                "is_unjoin": false
            },
            "department_ids": [
                "od-4e6ac4d14bcd5071a37a39de902c7141"
            ],
            "leader_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
            "job_title": "顾问",
            "custom_attrs": [
                {
                    "type": "ENUMERATION",
                    "id": "C-7245579267802529811",
                    "value": {
                        "text": "文本1",
                        "url": "https://www.feishu.cn",
                        "pc_url": "https://www.feishu.cn",
                        "option_value": "v2_d9033c89-a483-4efa-8d17-d02340fb16dj",
                        "picture_url": "https://www.xxxx.com/~?image_size=noop&cut_type=&quality=&format=png&sticker_format=.webp",
                        "name": "名字",
                        "generic_user": {
                            "id": "123456789",
                            "type": 1
                        }
                    }
                }
            ],
            "employee_no": "121212",
            "parent_department_ids": [
                {
                    "department_id": "902c7141",
                    "open_department_id": "od-4e6ac4d14bcd5071a37a39de902c7141"
                }
            ],
            "leader_id": {
                "user_id": "1dfsads",
                "open_id": "ou_8b8d8b4e310575fd7e4947cf6f1402ac",
                "union_id": "on_cad4860e7af114fb4ff6c5d496d1dd76"
            }
        }
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1971001 | User not visible to target tenant. | 无权限查询该用户，请咨询对方组织管理员配置该用户对关联组织的可见
400 | 1971010 | User not visible to target user. | 无权限查询该用户，请咨询我方管理员配置你对该用户的可见
400 | 1971007 | App not visible to target tenant. | 请在应用共享设置中配置对关联组织可用
400 | 1971009 | App not visible to target user. | 请在应用共享设置中配置应用对关联用户的可见