飞书开放平台

飞书开放平台是什么

飞书开放平台是飞书面向企业开发者、软件服务商和内部 IT 团队提供的应用开发与系统集成平台。开发者可通过开放 API、机器人、网页应用、小程序、事件订阅、AppLink 和客户端能力，把业务系统接入飞书的消息、通讯录、云文档、多维表格、审批、日历、招聘等协作场景，实现通知触达、流程自动化、数据同步和企业应用统一入口。

飞书开放平台的突出特点

• 覆盖飞书核心业务对象：开放消息、群组、用户与部门、文档、表格、多维表格、日历、审批及招聘等多类接口。
• 多种应用形态：支持企业内部使用的自建应用，也支持面向客户分发的商店应用，并可启用机器人、网页应用和小程序等能力。
• 事件驱动集成：通过事件订阅和回调接收消息、审批、通讯录等业务变化，适合构建自动化工作流。
• 完善的开发资料：提供开发文档、快速入门、代码示例、错误码、SDK、API 调试台和集成方案，便于排查权限与调用问题。
• 细粒度权限控制：应用需要申请相应权限，能够读取或写入的数据范围由应用权限、可用范围及租户授权共同决定。
• 连接协作场景：可将 CRM、项目管理、人事、客服、门禁和数据系统等外部服务嵌入飞书工作流。

核心能力与使用场景

消息与机器人能力可用于告警、通知、交互卡片和智能客服；通讯录接口适合组织架构及账号同步；云文档和多维表格 API 可创建、读取或更新协作内容；审批、日历和招聘接口可连接企业流程。开发者还可使用 AppLink 从网页唤起飞书内指定页面，通过服务端 SDK 调用 OpenAPI，或在小程序、网页应用和客户端扩展中构建交互界面。具体支持范围应以对应接口文档的应用类型、权限和版本要求为准。

如何使用飞书开放平台

1. 登录开发者后台，根据使用范围创建自建应用或商店应用，并配置名称、图标和负责人。
2. 启用机器人、网页应用或小程序等所需能力，按最小权限原则申请 API 权限并设置应用可用范围。
3. 获取应用凭证和访问令牌，使用 API 调试台或官方 SDK 验证接口；不要把密钥写入前端代码或公开仓库。
4. 配置事件订阅、回调地址和安全校验，完成测试、版本发布及管理员审核后再用于正式环境。

适合人群与注意事项

飞书开放平台适合企业开发者、信息化团队、SaaS 服务商、自动化工程师和希望将内部系统接入飞书的运营人员。开放文档和基础开发入口可免费访问，但部分接口、调用频率、应用分发、数据权限及企业功能可能受飞书版本、应用类型和管理员授权限制。涉及员工、客户、文档或聊天数据时，应只申请业务必需权限，妥善保管 App Secret 与访问令牌，并遵守数据保护、日志留存和应用下线要求。

常见问题

飞书开放平台可以免费使用吗？

开发文档、开发者后台和基础应用开发入口通常可以免费使用，但具体接口额度、企业功能及租户能力取决于飞书版本和官方当前规则。

自建应用和商店应用有什么区别？

自建应用主要服务本企业租户内部，商店应用面向多个客户安装和使用；两者的审核、授权方式、可用接口及发布流程不同。

飞书机器人可以发送哪些内容？

开放平台支持文本、富文本、图片、文件、音视频、表情和交互卡片等消息类型，但应用需启用机器人能力并获得相应消息权限。

调用飞书 API 为什么需要访问令牌？

访问令牌用于验证调用身份并限定权限范围。应用身份通常使用 tenant_access_token，具体令牌类型应按接口文档选择。

飞书开放平台支持哪些编程语言？

接口本身可通过标准 HTTP 调用，官方文档还提供多种服务端 SDK 和示例；具体支持语言及版本以 SDK 文档为准。

应用可以读取企业全部数据吗？

不可以默认读取。可访问的数据由已申请权限、管理员授权、应用可用范围和具体资源权限共同决定，应遵循最小权限原则。