# 申请 API 权限

调用服务端 API 之前，需要先申请相关应用权限。应用权限包括 **接口调用权限** 和 **字段访问权限**（针对部分敏感字段，需要额外申请字段访问权限）。

有关应用权限的详细介绍，请参考 [服务端 API 权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。

## 步骤一：确认所需权限

访问对应的 API 文档，在权限要求处，查看调用本接口需要申请的权限。
在[权限列表](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/scope-list)里可以查看权限说明、支持的应用以及关联的 API/事件。

如下图所示，在权限要求和字段权限要求处，描述了具体的权限要求：

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6ddcd99e8bd7df33de2919cb15b6e24e_c0G29ZMaGm.png?height=414&lazyload=true&maxWidth=650&width=987)

## 步骤二：申请所需权限

1. 登录[开发者后台](https://open.feishu.cn/app)，在应用列表处，点击应用，进入应用详情页。
2. 进入 **权限管理** 页面，定位到 **权限配置** 区域。
3. 勾选所有需要申请的权限后，点击右上角的 **批量开通**。
    权限的申请应该遵循**最小可用**的原则。权限范围过大可能会威胁企业数据安全，导致应用无法通过审核。在无充分理由的情况下，请注意杜绝直接申请大量的接口权限。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/de8b2e097df2cfea06347d1f38287b8f_D9r1bss7Sm.png?height=547&lazyload=true&maxWidth=650&width=1774)

## 步骤三：发布应用版本并等待审核完成
 如果申请的是自建应用的免审权限，则无需等待管理员审核，申请后立即生效。

如果申请开通的权限需要经过审核，页面上方会给出提示，如下图所示，点击 **点击创建**，会进入 **版本管理与发布** 页面，请创建版本，并等待审核完成。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/9e9f7f65abe5c6d3084edd8758f366f8_uTv6p1DLBw.png?height=755&lazyload=true&maxWidth=650&width=1510)

如下图所示，如果所申请权限，需要管理员审核，则管理员会收到审核提醒。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/d7a79db11fa4d7128e82d8905dade868_EcnX4wxwWq.png?height=899&lazyload=true&maxWidth=700&width=1280)

## 相关文档

- [API 权限：我能干什么](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)
- [权限列表](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/scope-list)