# 获取通讯录授权范围
该接口用于获取应用被授权可访问的通讯录范围，包括可访问的部门列表及用户列表。<br>
授权范围为全员时，返回的部门列表为该企业所有的一级部门；否则返回的部门为管理员在设置授权范围时勾选的部门（不包含勾选部门的子部门）。<br>

## 请求

基本 | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/contact/v1/scope/get
HTTP Method | GET
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 以应用身份访问通讯录(contact:contact:access_as_app)<br>读取通讯录(contact:contact:readonly)
字段权限要求<br>**接口返回的部分字段受权限控制，开启字段权限才可获取对应字段数据；如无需获取这些字段，则无需开启。**<br>根据要获取的字段开启相应权限 | 获取用户 user ID

### 请求头

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

## 响应
### 响应体

|参数|类型|说明|
|-|-|-|
|code|int|错误码，非 0 表示失败|
|msg|string|返回码的描述|
|data|-|返回业务数据|
|&emsp;∟authed_departments|list|已授权部门自定义 ID 列表，授权范围为全员可见时返回的是当前企业的所有一级部门列表|
|&emsp;∟authed_open_departments|list|已授权部门 openID 列表，授权范围为全员可见时返回的是当前企业的所有一级部门列表|
|&emsp;∟authed_employee_ids|list|已授权用户 employee_id 列表，应用申请了 `获取用户user_id` 权限时返回；当授权范围为全员可见时返回的是当前企业所有顶级部门用户列表|
|&emsp;∟authed_open_ids|list|已授权用户 open_id 列表；当授权范围为全员可见时返回的是当前企业所有顶级部门用户列表|
### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "authed_departments": [
            "TT-0001",
            "TT-0002"
        ],
        "authed_open_departments": [
        	 "od-8756c536552a91988b1b64559356c5a4",
            "od-a140b4eeb892b90a0ab3e616fc2054d6"
        ],
        "authed_employee_ids": [
            "c248363e",
            "98a42b48"
        ],
        "authed_open_ids": [
            "ou_5f3e2df282bf5aaeeaa2ea71ab9f1229",
            "ou_89ad6bf1fbf5a39796b556ae06a10d4d"
        ]
    }
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)