# 开放平台概述

飞书能力全面深度开放，作为信息的枢纽、业务的入口融入企业现有 IT 生态，良好地支撑和补充已有 IT 系统，提升企业数字化效能，助力企业打造 **一站式协同专属平台**，让企业员工专注业务、工作更简单，让 IT 人员敏捷开发、体验更愉悦。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/0edf16e890746cafc12a1e08bdb6391e_DsQYb3Bc5f.png?height=774&lazyload=true&maxWidth=700&width=2204)

用飞书开放平台集成企业现有系统，可以快速打破系统间的壁垒，让信息传递更高效。企业可以在现有系统和新建应用中调用飞书文档、通讯录、消息、用户名片等多个飞书模块能力，高效协同不止于飞书。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/1eb30a67a435a06291d60d85da276d83_XYJc7aPdrr.png?height=715&lazyload=true&maxWidth=700&width=1451)

# 多种应用形态，适配多样场景

按照应用形态，飞书应用可以分为 **机器人**、**网页应用、小组件** 应用，不同应用形态所支持的能力有所差异。详情参考[应用能力介绍](https://open.feishu.cn/document/home/app-types-introduction/overview)。

应用形态 | 机器人（Bot） | 网页应用（H5） | 小组件（Block）
---|---|---|---
功能场景 | ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/40f514e82745dfb427c5975c2d2b7749_QQOANXNsUm.png?height=1856&lazyload=true&maxWidth=200&width=2560)<br>机器人是一种基于会话与用户进行交互的应用，通过集成飞书日历、审批、文档及第三方业务系统，可在飞书中实现一站式聚合各类应用的通知（如监控警报、待办提醒、数据报告等），同时支持自动化管理群组、监听并响应用户消息等能力。<br>详情参考 [机器人概述](https://open.larkoffice.com/document/client-docs/bot-v3/bot-overview)。 | ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/79a88e09e299112c40fdae0f78c0119e_5I6K21acic.png?height=1856&lazyload=true&maxWidth=200&width=2560) <br>网页应用指的是用 H5 方式开发，可以运行在飞书客户端内的应用。通过调用飞书开放接口（如身份认证、通讯录、云文档等）深度集成飞书生态能力。集成 SSO 免登系统后，企业可将已有应用快速迁移。<br>详情参考 [网页应用概述](https://open.larkoffice.com/document/client-docs/h5/introduction#b2fbd674)。 | ![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/96e57a7ef2d4e42d8e33a04b234e3610_fN0sRpIumx.png?height=764&lazyload=true&maxWidth=200&width=1280) <br>小组件是飞书独创的轻量级功能块，是一个集渲染、交互、数据为一体的信息单元载体，实现信息在飞书套件内的顺畅流转与消费。通过小组件，企业 IT 和第三方服务商可以开发各类垂直场景的应用，实现文档协作与企业工作流的打通，扩展飞书套件的能力，进而提升效率。<br>详情参考 [云文档小组件概述](https://open.larkoffice.com/document/client-docs/docs-add-on/docs-add-on-introduction)、[多维表格插件概述](https://open.larkoffice.com/document/uAjLw4CM/uYjL24iN/base-extensions/base-extension-introduction)。

# 全面的开放能力，赋能日常办公

飞书开放平台现已提供 2500 多个 标准化服务端 API 接口（详情参考 [开放能力列表](https://open.larkoffice.com/document/server-docs/api-call-guide/server-api-list)）。企业可通过集成云文档、多维表格、通讯录、消息、群组、日历等核心功能模块，在现有系统升级或新应用开发中快速构建协同办公解决方案，实现组织内外部的高效协作与流程整合。

## 消息与群组

飞书提供了一系列即时通讯场景的 API，通过创建飞书机器人并调用 [消息与群组 API](https://open.larkoffice.com/document/server-docs/im-v1/introduction)，可以实现多种功能，例如：
- **发送不同类型的飞书消息**：如文本、富文本、图片、文件、可交互的 [飞书卡片](https://open.larkoffice.com/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/feishu-card-overview)、视频、音频、表情等。
- **飞书群组管理**：如创建群组、拉用户或机器人入群。

场景 | 场景描述 | API 及参考示例
---|---|---
运维告警自动拉群 | 信息化时代，企业在各类业务系统上进行运作，为了保障服务的稳定性，各业务系统往往都会在 IaaS 到业务层加上各种监控，在异常发生时可以第一时间处理，保障服务的稳定性。基于飞书开放能力，我们可以实现通过飞书机器人自动创建飞书项目群，并拉入相关的负责人员，实现根据消息来源和业务规则为每个告警创建专属处理群：<br><ul><br><li>群内推送报警通知，提示故障内容。</li><br><li>在群内协同并及时同步进展，事后也可以通过群组沟通记录及时进行复盘。</li><br><li>当问题解决时，机器人可将群名自动修改为“已解决”。</li><br></ul><br>![运维告警自动拉群](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/147e852aabd6066ea4148e0c7fb72ca0_P5iNRz30X4.png?height=1000&lazyload=true&maxWidth=300&width=1600) | **API/能力：**<br><ul><br><li>[创建群](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/create)</li><br><li>[更新群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/update)</li><br><li>[将用户或机器人拉入群聊](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-members/create)</li><br><li>[发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)</li><br></ul><br>**开发教程：**<br>[机器人自动拉群报警教程（含示例代码）](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-development-tutorial/introduction)<br>**客户案例：**<br>[华住：基于飞书的开放能力打造统一告警解决方案，帮助信息高效流转和处理，并自动沉淀方便回溯和复盘](https://open.feishu.cn/solutions/detail/alert)
工单/反馈自动流转 | 以工单处理场景为例，基于现有的接口能力，我们可以实现从沟通群组建、进度更新到信息归档的自动化闭环，将手动操作降到最低；<br><ul><br><li>当内部同学在指定渠道发起咨询反馈时，我们可以通过机器人快速创建群聊，添加对应人员进群。</li><br><li>创建的群聊可根据既定的规则自动设置群名、群头像等基础信息，便于群内人员清晰了解群聊主题（例如：可根据问题类型匹配不同的群头像，便于信息识别）。</li><br><li>完成处理后，机器人可通过接口自动获取会话的完整历史消息，用于重要信息的收集与归档。</li><br><li>同时，机器人也可在归档后解散群聊，避免过多无用群组。</li><br></ul><br>![工单/反馈自动流转](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/ad6aafe2abaef0e256c0863e1ec54377_APjawXMm6u.png?height=1040&lazyload=true&maxWidth=300&width=1640) | **API/能力：**<br><ul><br><li>[创建群](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/create)</li><br><li>[更新群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/update)</li><br><li>[获取会话历史消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list)</li><br></ul><br>**客户案例：**<br>[理想汽车：创建了智能工单机器人，让多渠道工单统一流转，并配置出符合理想工作法的工单规则，实现了任务自动化](https://open.feishu.cn/solutions/detail/ticket)

## 通讯录（组织架构）

通讯录可理解为企业的组织架构，包括企业部门信息，企业人员信息等，飞书提供了一系列安全、可靠的 API 对通讯录信息进行操作。通过调用 [通讯录 API](https://open.larkoffice.com/document/server-docs/contact-v3/resources)，你可以实现多种功能，例如：

- 查看企业的组织架构
- 为企业创建新的用户
- 修改企业中已有用户的基本属性
- 维护用户和部门的关联关系
- 维护用户和用户组的关联关系

场景 | 场景描述 | API 及参考示例
---|---|---
HR 系统集成组织架构同步 | 入职、转正、调岗、离职，是企业人力资源管理的重要环节。一般来说，HR 需要人工完成这些流程的审批和通知，并且手动维护员工的企业通讯账号和群信息，不仅费时费力，且容易出错遗漏。当 HR 系统与飞书集成后，飞书应用能根据人事变动、审批流程的进展，自动通知提醒 HR 和员工流程状态以及接下来需要做的事情，避免工作的疏漏，保证各流程顺利进展。当流程完成时，飞书应用可以自动完成人员账号的变更，让“入转调离”的流程变得更高效和规范。<br><ul><br><li>人员数据实时同步，告别繁琐手动维护</li><br><li>转调离在线审批，流程指引更清晰</li><br><li>入职推送学习指南，助力快速融入团队</li><br></ul><br>![HR 系统集成组织架构同步](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/680d4d7563d4e1e61b094e5296cbca97_SsvmoOSgPC.png?height=1100&lazyload=true&maxWidth=360&width=1600) | **API/能力：**<br><ul><br><li>[创建部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/create)</li><br><li>[修改部门部分信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/patch)</li><br><li>[创建用户](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create)</li><br><li>[发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)</li><br></ul><br>**开发教程：**<br>[将企业组织架构同步到飞书](https://open.feishu.cn/document/home/synchronize-corporate-organizational-structure-to-feishu/synchronize-corporate-organizational-structure-to-feishu)<br>**客户案例：**<br>[HR 系统集成飞书，“入转调离”管理更轻松](https://open.feishu.cn/solutions/detail/hr)

## 云文档

云文档是飞书在线文档、电子表格、多维表格、知识库、云空间等产品的统称。通过调用 [云文档 API](https://open.larkoffice.com/document/server-docs/docs/docs-overview)，可以完成以下操作：
- 上传、下载文件
- 创建、编辑各类在线文档、电子表格、多维表格
- 管理你所有的文件和文件夹、知识库

场景 | 场景描述 | API 及参考示例
---|---|---
自动化周报/月报 | 通过自动化周报、日报，能够规范周报日报格式、自动化催办、提醒，提升周报日报的交付质量和时效，节省人力。使用开放平台云文档能力进行团队周报管理：<li>   通过周报模板文档每周定时创建出新一周周报，并给团队成员授权文档编辑权限</li> <li> 自动将新周报文档归档到知识库指定节点</li> <li> 通过群机器人发送群消息通知所有人更新本周周报内容</li>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/77eb4617fadc15f0af6847f4b3f35213_lqvTJg0yIb.png?height=400&lazyload=true&width=752) | **云文档 API** <li> [获取空间根目录](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/get-root-folder-meta) </li> <li> [获取文件夹下文档清单](https://open.feishu.cn/document/ukTMukTMukTM/uEjNzUjLxYzM14SM2MTN) </li> <li> [获取元数据](https://open.feishu.cn/document/ukTMukTMukTM/uMjN3UjLzYzN14yM2cTN)  </li> <li> [复制文档](https://open.feishu.cn/document/ukTMukTMukTM/uYTNzUjL2UzM14iN1MTN) </li> <li> [增加权限](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create) </li> <li> [添加知识空间成员](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-member/create) </li> <li> [添加已有云文档至知识库](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/move_docs_to_wiki) </li> <br>**消息与群组 API**：<li> [获取用户或机器人所在的群列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/list) </li> <li> [发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)  </li> <br>**开发教程**：<li> [自动化周报](https://open.feishu.cn/document/home/management-weekly-report-based-docs/introduction)</li>
基于电子表格统计销售额 | 使用飞书电子表格的开放能力，可以实现将外部销售额数据同步到电子表格中并进行总额统计：<li> 通过接口创建出新的电子表格 </li> <li> 写入外部数据、添加SUM统计公式并设置样式 </li> <li> 给指定用户设置文档权限</li>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/8f8123a3e02f72d140866df5a1c9d340_WNOWuMPhLJ.png?height=600&lazyload=true&width=1128) | **云文档 API**： <li> [获取空间根目录](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/get-root-folder-meta) </li> <li> [创建表格](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/create) </li> <li> [获取表格元数据](https://open.feishu.cn/document/ukTMukTMukTM/uETMzUjLxEzM14SMxMTN) </li> <li> [向多个范围写入数据](https://open.feishu.cn/document/ukTMukTMukTM/uEjMzUjLxIzM14SMyMTN) </li> <li> [批量设置单元格样式](https://open.feishu.cn/document/ukTMukTMukTM/uAzMzUjLwMzM14CMzMTN) </li> <li> [增加权限](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-member/create) </li> <br>**开发教程**：<li> [电子表格统计销售额](https://open.feishu.cn/document/home/sales-statistics-base-on-spreadsheets/sales-statistics-based-on-sheets)</li>
知识库周报文档待办事项每日提醒 | 使用开放平台云文档能力通过知识库接口查找到最近一期周报文档，用文档内容获取接口读取出周报中的待办事项，提取出待办事项的内容、负责人、截止时间并封装为提醒消息，发送消息到团队群进行待办事项的每日提醒。![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/c521cab366568d1051556a1637935e10_fp9yByJDVI.png?height=600&lazyload=true&width=1128) | **登录 API**：<li> [获取 tenant_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/tenant_access_token_internal) </li> <br>**云文档 API**： <li> [获取子节点列表](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/list) </li> <li> [获取节点信息](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node) </li> <li> [获取文档富文本内容](https://open.feishu.cn/document/ukTMukTMukTM/uUDM2YjL1AjN24SNwYjN)  </li><br>**消息与群组 API**： <li> [获取用户或机器人所在的群列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/list) </li> <li> [发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create) </li>
基于多维表格管理敏捷项目 | 多维表格不仅是一个表格，也是无数个应用，千人千面，万人万解。使用多维表格进行敏捷项目管理，通过日历开放能力将项目版本迭代周期创建为公开日历，供全团队订阅。![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/296668c0a38d826ce29d9d6fbba3de78_cWaFPeCHth.png?height=600&lazyload=true&width=1128) | **登录 API**：<li> [获取 tenant_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/tenant_access_token_internal) </li> <br>**云文档 API**： <li> [列出记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/list) </li> <li> [更新多条记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_update) </li> <li> [新增多条记录](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_create) </li> <li> [新增数据表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/create) </li> <li> [列出字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/list) </li> <li> [新增字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/create) </li> <li> [更新字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/update) </li> <br>**日历 API**： <li> [创建日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/create) </li> <li> [发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create) </li> <br><li> **开发教程**：</li> <li> [多维表格管理敏捷项目](https://open.feishu.cn/document/home/agile-project-cycle-management-based-on-bitable/introduction)</li>
文档数据迁移后替换链接 | 在数据迁移场景中，可以通过飞书开放能力，将本地文件导入到飞书云文档，提取飞书文档中过期的链接，并修正为导入后的新链接地址。![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/4deec4429a1fd23d230abbfaf46c275a_eZKmI3rM2T.png?height=600&lazyload=true&width=1128) | **登录 API**： <li> [获取 tenant_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/tenant_access_token_internal) </li> <br>**云文档 API** ：<li> [获取空间根目录](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/get-root-folder-meta) </li> <li> [上传文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_all) </li> <li> [创建导入任务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/create) </li> <li> [查询导入任务结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/get)</li> <li> [更新云文档权限设置](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public/patch) </li> <li> [获取文档所有块](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/list) </li> <li> [更新块](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/patch) </li> <br>**开发教程**： <li> [文档数据迁移后替换链接](https://open.feishu.cn/document/home/replace-links-in-documents-after-data-migration/introduction)</li>

## 日历

飞书基于日历功能开放了对日历、日程、忙闲等实体的操作查询能力，通过调用[日历 API ](https://open.larkoffice.com/document/server-docs/calendar-v4/overview)，你可以实现多种功能，例如：

- 创建日程/会议室预定
- 邀请飞书用户/第三方用户参与日程
- 查询用户忙闲查询
- 同步用户休假状态
- 绑定/解绑 exchange 账户

场景 | 场景描述 | API 及参考示例
---|---|---
会议管理 | 会议是企业高频的办公场景。在组织会议的过程中，往往会遇到逐一确认参会人时间，线下沟通费时费力；协调线下会议室时间找不到申请人；反复确认参会人是否可以参会等令人苦恼的问题，特别是组织 50 人以上中、大型会议的时候，简直是一场与时间赛跑的战斗。飞书基于开放能力，为企业构建一整套智能会务解决方案，通过有机串联日程、会议、会议室，将企业内的会议日程与飞书日历、会议室打通，自动同步会务日程、会议室线上预定、参会状态实时确认。不仅可以给所有参会者带来更好的体验，也能够将企业内的会议组织工作通过飞书线上化、自动化，进一步提高会议质量和企业日常办公效率，打造愉悦的办公氛围。![会议管理](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/c51b13b50b49e5c50aa241e370f570e5_13Sg132WJe.png?height=1100&lazyload=true&width=1600) | **API/能力：**<br><ul><br><li>[查询用户日程忙闲](https://open.feishu.cn/document/ukTMukTMukTM/uMjM3YjLzIzN24yMycjN)</li><br><li>[创建日程](https://open.feishu.cn/document/ukTMukTMukTM/uYTM3YjL2EzN24iNxcjN)</li><br><li>[增加日程参与者及会议室](https://open.feishu.cn/document/ukTMukTMukTM/ukjM3YjL5IzN24SOycjN)</li><br><li>[更新日程时间](https://open.feishu.cn/document/ukTMukTMukTM/uAjM3YjLwIzN24CMycjN)</li><br><li>[增加日程参与方](https://open.feishu.cn/document/ukTMukTMukTM/ukjM3YjL5IzN24SOycjN)</li><br><li>[删除日程参与方](https://open.feishu.cn/document/ukTMukTMukTM/uAzM3YjLwMzN24CMzcjN)</li><br><li>[删除日程](https://open.feishu.cn/document/ukTMukTMukTM/ucTM3YjL3EzN24yNxcjN)</li><br></ul><br>**客户案例：**<br>[飞书智能会务，轻松搞定会议管理](https://open.feishu.cn/solutions/detail/meetings)
休假状态同步 | 在许多企业，员工在请假系统中的申请被审批通过后，其请假状态并不会同步到企业内部使用的通讯软件上。这样一来，其他同事可能会在不了解该员工当天请假的情况下，为其安排工作、会议或者任务，进而给团队和个人都带来了诸多不便。现在，你可以打通飞书与企业的 HR 系统，在飞书中实时同步员工的请假信息。在员工请假当日，员工个人名片及个人日历面板等位置将出现显眼的“请假”标识，方便同事及相关人员知悉，及时调整工作安排。![休假状态同步](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/4b791f69980692704eea5d2a9dabfb96_6TY6gKnmr9.png?height=826&lazyload=true&width=1640) | **API/能力：**<br><ul><br><li>[创建请假日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/create)</li><br><li>[删除请假日程](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/timeoff_event/delete)</li><br></ul><br>**开发教程：**<br>[自动获取日历日程](https://open.feishu.cn/document/home/calendar-event-sync/prepare)<br>**客户案例：**<br>[中国移动国际有限公司：休假状态实时同步，沟通协作更高效](https://open.feishu.cn/solutions/detail/leave)

# 丰富的网页组件，快速嵌入企业自有系统

飞书开放平台基于飞书特色协同功能，还提供了一系列网页组件，帮助企业快速将自己的系统和飞书紧密连接，快速复用飞书特色协同功能至你的系统，低成本拥有云文档能力、成员名片能力、评论能力等。

&nbsp; | 云文档组件 | 成员名片组件 | 搜索组件
---|---|---|---
**功能介绍** | [云文档组件](https://open.larkoffice.com/document/uYjL24iN/uYDO3YjL2gzN24iN3cjN/introduction)（Docs Component）支持开发者将云文档嵌入业务系统，让企业应用具备在线文档功能。用户可以在嵌入文档的系统里协同编辑、评论文档，以及进行用户权限管理。通过轻量化集成云文档，将不同的系统串联起来。 | [成员名片组件](https://open.larkoffice.com/document/uYjL24iN/uQDO3YjL0gzN24CN4cjN/profile-component) 功能可以帮助团队成员之间更好地认识对方，了解基本信息，降低沟通成本。调用成员名片组件，你就可以在网页中展示飞书成员名片，并支持通过名片上的按钮发起飞书聊天、查看 OKR 等。该组件支持多语言适配（中文、英文、日文等），同时支持配置浅色模式或深色模式。 | [搜索组件](https://open.larkoffice.com/document/common-capabilities/web-components/selector) 可用于搜索和选择人员、群组、文档等数据的场景，匹配关键词检索对应结果，并支持多类型数据混排展示。该组件支持多语言适配（中文、英文、日文等），同时支持配置浅色模式或深色模式。
**功能示意** | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b592b626638a67411a13789740b94b42_VBOmtQFtUZ.png?height=720&lazyload=true&width=886)<br>在企业应用中集成飞书文档的编辑、评论、用户权限管理等能力，内容协同更高效。通过轻量化集成云文档，借助文档强大的协作能力，把你的系统串联起来。一次编辑，多处同时生效。 | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/5f8ce9f36a50fb4541a656f59f16210c_8FmTKcTIcI.gif?height=1288&lazyload=true&width=1631)<br>上图是某企业内的项目管理系统（浏览器网页）：<ul><li>当用户想了解负责人，点击负责人，即可打开该负责人的 **“成员名片页”** ，查看负责人的基本信息。</li><li>当用户对项目有疑问，则可以直接从 **“成员名片页”** 中点击 **“消息”** 按钮，快速打开与负责人的飞书聊天会话，大幅提升项目协同效率。</li><br></ul> | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b914f9f335b3bfda26e704ef4087e23d_cEq0of5a8z.gif?height=897&lazyload=true&width=1435)<br>上图是某企业内的信息管理系统（浏览器网页）：<br><ul><br><li>当用户想针对某条信息进行授权管理，授权弹窗内包含“搜索框”组件，可输入关键词进行人员、群组的搜索；</li><br><li>搜索完成后，可选择对应的人员或群组，即可完成对所选范围的授权。</li><br></ul>

# 灵活的集成模式，满足不同开发背景

开发者可以根据自身的背景经验，灵活选择不同的集成方式。除了全代码方式进行 API 调用和集成，你还可以选择低代码方式快速构建应用，或者零代码的可视化流程编排实现业务集成。通过结合飞书开放平台与其他集成平台，开发者可以选择最适合的方式，快速高效地完成业务开发和集成，降低复杂度和成本。

开发模式 | 集成平台 | 低代码开发 | 零代码开发 | 开发 AI 智能体
---|---|---|---|---
平台能力 | [飞书集成平台](https://anycross.larkoffice.com/)（AnyCross）为企业提供标准、高效的系统集成能力，为企业构建强大的集成解决方案，实现企业的全域数据互通。让企业的业务系统集成更标准、更安全、更简单。 | [飞书低代码平台](https://apaas.feishu.cn/ae/portal)（aPaaS）为企业提供全代码的底层能力、低代码的开发体验，武装每个开发者成为全栈工程师，让复杂的业务系统也能交付更敏捷、体验更友好。 | [飞书多维表格](https://bytedance.larkoffice.com/base) （Base）提供视图、仪表盘、表单、自动化和插件等能力，定制专属业务系统。 | [飞书智能伙伴搭建平台](https://aily.feishu.cn/)（Aily）围绕着大语言模型（LLM）提供 AI 技能编排、知识数据处理、效果调优和持续运营能力，让用户可以高效的开发出专业的企业级智能应用，并一键发布到飞书、Web 等多个渠道。
功能示意 | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/163ea21b27ff2db8bba7a28a438ba92d_ZWGl8aetOM.png?height=2072&lazyload=true&width=2540) | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/491a83047cfc76dc8bb9c5fca7a05f97_ataCwK5ra4.png?height=3240&lazyload=true&width=5760) | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/4cfaba5d082ff513f15c224d7e36b5da_vnSZ1hwLhi.png?height=1566&lazyload=true&width=2828) | ![功能示意](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/0b626da32275e45d9c85fb54d4468c8b_1L1EzgIq8f.png?height=1314&lazyload=true&width=3332)

# 客户案例

在数字化转型过程中，企业常面临系统割裂、数据孤岛、流程低效等核心挑战。我们通过丰富灵活的开放能力整合 CRM、OA、ERP 等系统，打通业务闭环，实现审批自动化、数据实时互通与跨部门协同，助力企业降本增效。以下是典型的客户案例，更多客户实践请参考 [客户案例](https://open.larkoffice.com/solutions)。

场景 | 业务痛点 | 解决方案
---|---|---
**财务审批管理** | 每天有大量的流程需要经你审批。在业务系统找到单据点击通过不难，难的是流程审批与对应执行的割裂，你的一天就在确认申请人、申请理由的合理性、手工去对应系统执行操作、将操作结果反馈给申请人的不断循环中消耗完了。 | [ 得物如何利用飞书开放能力实现智能审批管办一体](http://open.feishu.cn/solutions/detail/automation?from=intro)
**销售知识协同** | 工作日常是支持门店的销售、交付和售后维修需求，在你服务客户的过程中常常涉及到专业术语和最新政策知识的查询，对于客户的定制化需求和疑难杂症有时还需要连线专家支持，如何能快捷获取到最新最全的知识，并联系到最对口的专家及时支持呢？ | [ 理想汽车的自动化解决方案](http://open.feishu.cn/solutions/detail/ticket?from=intro)
**企业业务运营** | 负责门店经营、供应链、营销活动管理等多项工作，时常需要查询数据、分析数据。在外奔波移动时，用手机打开业务系统看数十分困难，更别提希望实时获得数据和尽早捕捉异常数据了。 | [ 沪上阿姨如何利用机器人让业务数据随手可得](http://www.feishu.cn/customers/hsay)

# 快速入门

你可以学习以下入门教程，快速体验飞书开放平台的应用开发，了解具体的实现效果。

[快速调用一个服务端 API（发送消息）](https://open.larkoffice.com/document/uAjLw4CM/uMzNwEjLzcDMx4yM3ATM/how-to-call-a-server-side-api/introduction)![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/cfa643e2732f89cb36d9aa29dd6964ee_5FIPATmeWX.png?height=400&lazyload=true&width=752) | [快速调用一个服务端 API（创建多维表格）](https://open.larkoffice.com/document/uAjLw4CM/uMzNwEjLzcDMx4yM3ATM/call-a-server-api-base-example/introduction)![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/8d80d4ac367f4bc1d99df530a7756c8f_eZDyaGFvHK.png?height=400&lazyload=true&width=752) | [开发一个自动回复机器人](https://open.larkoffice.com/document/uAjLw4CM/uMzNwEjLzcDMx4yM3ATM/develop-an-echo-bot/introduction)![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/039b9a3b35dcf52e862ae9e09e3901b8_yYMWNDmp8H.png?height=400&lazyload=true&width=752)
---|---|---
[开发一个卡片交互机器人](https://open.larkoffice.com/document/uAjLw4CM/uMzNwEjLzcDMx4yM3ATM/develop-a-card-interactive-bot/introduction)![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/790a994db711394a06b4e20300309f74_S7rdiE88Bi.png?height=800&lazyload=true&width=1504) | [将已有网页应用嵌入飞书工作台](https://open.larkoffice.com/document/uAjLw4CM/uMzNwEjLzcDMx4yM3ATM/embed-web-app-into-feishu-workbench/introduction)![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/63217f3bda1d2885ac25186877bb3157_YEr3syMSrI.png?height=400&lazyload=true&width=752) | [快速开发网页应用（Node.js）](https://open.larkoffice.com/document/home/quickly-develop-a-web-app-nodejs/introduction)![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/6a2fd10553ac03b17891392fdad67c59_ZJ0y9ykMRX.png?height=400&lazyload=true&width=752)

# 开发工具

飞书提供从 **调研入门** 到 **调试发布** 的全链路工具支持，开发者可根据需求灵活组合使用，降低开发门槛。更多工具资源，参考[开发工具概述](https://open.feishu.cn/document/developer-tools-portal)。

## 智能助手

**[开放平台智能助手](https://open.larkoffice.com/search?from=home&page=1&pageSize=10&q=%E5%A6%82%E4%BD%95%E4%B8%8B%E8%BD%BD%E8%AF%9D%E9%A2%98%E7%BE%A4%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E6%B6%88%E6%81%AF%E4%B8%AD%E7%9A%84%E5%9B%BE%E7%89%87&topicFilter=)** 是一款专为开发者打造的全流程效率工具，覆盖开发全生命周期核心场景。当前已实现三大核心能力支撑：
- **概念解释**：当开发者遇到难以理解的复杂概念，智能助手可以快速索引并整合相关信息，为开发者提供清晰易懂的解释，帮助开发者降低认知负荷，快速学习上手。[立即体验](https://open.larkoffice.com/search?from=banner&lang=zh-CN&page=1&pageSize=10&q=%E8%A7%A3%E9%87%8A%EF%BC%9Aopen%20id&topicFilter=)。
- **方案设计**：在需求调研阶段，提供结构化的的实现思路和完整的实现路径及示例代码引导，帮助开发者更好地规划和执行项目，进一步提升开发效率。[立即体验](https://open.larkoffice.com/search?from=banner&page=1&pageSize=10&q=%E5%A6%82%E4%BD%95%E4%B8%8B%E8%BD%BD%E8%AF%9D%E9%A2%98%E7%BE%A4%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E6%B6%88%E6%81%AF%E4%B8%AD%E7%9A%84%E5%9B%BE%E7%89%87&topicFilter=)。
- **报错诊断**：当开发者在调用服务端 API 遇到错误时，智能助手可以根据 logid 或报错信息进行诊断分析，并提供完整清晰的修复建议，帮助开发者自主高效解决问题。[立即体验](https://open.larkoffice.com/search?from=doc&lang=zh-CN&page=1&pageSize=10&q=202407211618216F3E9EB64DC7E1234&topicFilter=)。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/a5200e673a65c25d60ec09b675a16825_LpaeNLAvrA.png?height=1398&lazyload=true&maxWidth=420&width=1990)

## API 调试台

[API 调试台](https://open.larkoffice.com/api-explorer/)是一款一站式的提升接口调试效率的飞书应用开发工具。通过 API 调试台，你无需编写代码，即可快捷完成服务端的接口调用。此外，调试台提供了以下功能，提升接口调试效率：
- **自动获取** **鉴权** **凭证**：绑定你的应用一键获取 token，每次调试无需再额外发起请求获取。
- **内置** **应用权限申请**：调通接口所需权限一目了然，无需跳转后台，调试台内快捷申请。
- **接口调试示例代码**：提供多语言示例代码，点击复制即可快速复用至业务代码中。
![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/96ea605deef8b9d4ac3111b86a3e4b68_A0U8DLGaRM.gif?height=510&lazyload=true&maxWidth=700&width=1100)

## 服务端 SDK

飞书开放平台提供了一系列服务端的原子 API 来实现多元化的功能，但在实际编码过程中，需要考虑一些额外的工作，如访问凭证（access token）的获取与维护、数据加解密、请求验签等。此外，缺少函数调用的语义化描述、类型系统的支持，也会增加编码负担。
为解决以上问题，飞书开放平台提供了[服务端 SDK](https://open.larkoffice.com/document/server-docs/server-side-sdk)，以提高实际的编码体验。
SDK 提供的主要能力包括：
- SDK 支持 **基于** **长连接** **的事件回调**，详见 [配置事件订阅方式](https://open.larkoffice.com/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-subscription-configure-/request-url-configuration-case#d286cc88)、[配置回调订阅方式](https://open.larkoffice.com/document/uAjLw4CM/ukTMukTMukTM/event-subscription-guide/callback-subscription/configure-callback-request-address)。
- SDK 提供了 **结构化的 API 请求入参**。比如发消息 API，SDK 对各种类型的消息都提供了结构化封装。<br>
![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/f050014d35eb6b9b8ed16e2f037a7687_Fb2eXR071d.png?height=478&lazyload=true&maxWidth=500&width=1482)
- SDK 提供了 **完整的应用访问凭证（tenant_access_token）生命周期管理能力**，无需开发者自己获取并刷新应用身份的访问凭证。
- SDK 提供了简洁易懂的帮助文档。参考 SDK 文档可帮助你了解如何安装 SDK、如何通过 SDK 调用服务端 API、处理订阅的事件及回调，详见 [服务端 SDK 概述](https://open.larkoffice.com/document/server-docs/server-side-sdk)。

# 技术支持

- **获取技术支持**：点击官网任意页面的右下角的 [技术支持](https://applink.larkoffice.com/TLJpeNdW) 入口，即可咨询开发过程中的问题，技术支持人员 1 对 1 协助你解决。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/07d58aa93d2e410515ea197582ec285b_rxF9WmhrJF.png?height=1576&lazyload=true&maxWidth=500&width=2940)

- **文档问题反馈**：如果你在开发过程中发现开发文档有错误，你可以直接在文档页面划词反馈，内容将直达文档的编写人员，有效的内容问题将获得及时处理。
- **SDK** **交流群**：在使用 SDK 的过程中，如果遇到问题，可以加入以下 SDK 交流群，Node.js 问题可直接提交 [Issues](https://github.com/larksuite/node-sdk/issues)。

| **Java SDK 交流群**      | **Python SDK 交流群**   | **Go SDK 交流群**    |
| --------- | --------- | --------- |
| [单击此处](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=a53jb5f6-87de-4974-9ad6-8a88563d0e89) 或扫码加入 SDK 交流群。<br>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/003954d32d2287244574f5bde1e3fe3b_8j3YF1su7U.png?height=243&lazyload=true&maxWidth=160&width=242) | [单击此处](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=575k28fa-2c12-400a-80c0-2d8924e00d38) 或扫码加入 SDK 交流群。<br>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/f3953f5409870df2b0f07981b7a528ff_AHgUGM0JEN.png?height=748&lazyload=true&maxWidth=160&width=758) | [单击此处](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=21cn476d-b859-4c15-9048-5ecf49f1a951)或扫码加入 SDK 交流群。<br>![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/4f677b046cab071488fc4e6fcc0736e8_rElwngiWwL.png?height=284&lazyload=true&maxWidth=160&width=286) |

- **加入开发者社群**：想获取最新能力的内测机会，并与其他企业开发者交流，欢迎你加入[飞书开发者社群](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=b65mf2e5-f5f0-426a-9c51-01b33a46acd8)。了解更多，前往[飞书开发互助交流社群传送门](https://bytedance.larkoffice.com/docx/T0Krdi1iXoGC6exDkQycgzKvngh)。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/3f3b7d4e0f89422b39232eee6e107bf0_CtPcZlD7sz.png?height=380&lazyload=true&maxWidth=300&width=1440)