一、平台定位

飞书开放平台是飞书官方全量开放能力底座，提供 2500 + 标准 API、事件、多形态应用开发能力，核心目标：打通企业内部异构系统、在飞书内自建业务应用、第三方服务商上架标准化 SaaS，把飞书变成企业统一办公入口与业务中台飞书。

三大核心价值：

1. 集成现有系统：ERP、CRM、OA、监控、业务后台接入飞书，消息、待办、数据统一聚合
2. 自建内部应用：企业 IT 开发专属工具，仅本组织可用
3. ISV 商用生态：服务商开发通用应用上架飞书应用市场，全行业企业付费使用

二、核心开放能力体系

1. 服务端 API（最基础能力）

覆盖飞书全部核心模块，配套事件回调实时监听数据变更：

表格

模块	核心能力
通讯录 People	成员 / 部门 / 角色同步、组织架构读写、身份鉴权、SSO 扫码登录
消息 & 群组 IM	发文本 / 卡片 / 文件、自动建群、消息监听、机器人交互
云文档套件	文档 / 表格 / 幻灯片 / 知识库读写、权限管理、在线协作
多维表格 Base	数据表增删改查、视图、自动化、自定义插件
审批	流程发起、审批节点、待办回调、审批数据拉取
日历 / 会议	日程创建、会议预约、参会管理、录制文件获取
考勤、OKR、招聘、绩效	人力全流程数据读写

2. 四种主流应用开发形态

（1）机器人 Bot（会话型应用）

运行在聊天窗口，自动收发消息、推送告警、处理指令：

• 场景：监控告警推送、工单自动同步、群自动管理、问答机器人、定时报表推送
• 载体：飞书群 / 单聊，支持交互式卡片按钮

（2）网页应用 WebApp（内嵌 H5）

完整业务页面嵌入飞书侧边 / 独立窗口，适配客户端 PC / 移动端：

• 场景：内部 ERP、项目管理、数据后台、表单填报
• 优势：一套 H5 代码，免客户端安装，获取飞书登录身份

（3）小组件 Block（文档 / 表格嵌入式插件）

嵌入云文档、多维表格单元格，轻量化功能扩展：

• 文档 Block：文档内插入业务数据、表单、看板
• Base 插件：多维表格单元格自定义渲染、批量操作工具

（4）飞书卡片 Card（交互式消息组件）

富交互消息载体，带按钮、下拉、输入框，用于审批、工单、问卷、数据报表推送。

3. 网页嵌入组件（反向集成）

在企业自有官网 / 后台嵌入飞书原生能力，不用跳转飞书客户端：

• 文档组件：网页内嵌可编辑飞书文档
• 成员名片：展示员工信息，一键发起飞书聊天
• 选人组件：弹窗选择飞书成员 / 部门 / 群组

4. 企业专属定制能力

• 客户端品牌定制：logo、登录页、导航栏私有化
• 私有化部署 SDK：本地部署飞书时深度打通内部 IT 基础设施

三、两种开发身份（应用类型）

1. 自建应用（企业内部自用）

• 使用主体：企业 IT、内部开发者
• 范围：仅当前企业可用，不上应用市场
• 典型场景：内部工单、产线监控、财务报销、员工自助工具
• 权限：仅能访问本企业组织数据

2. 商店应用（ISV 服务商商用）

• 使用主体：软件服务商、SaaS 厂商
• 范围：上架飞书应用市场，所有飞书企业可安装购买
• 资质：企业认证、服务商入驻、资质审核
• 盈利：付费应用、增值功能收费

四、开发全流程（极简版）

1. 注册开发者账号：开放平台官网 open.feishu.cn，绑定飞书企业管理员账号
2. 创建应用：选择「自建应用 / 商店应用」，填写名称、权限范围
3. 配置凭证：获取 AppID/AppSecret（服务端调用凭证）、事件回调地址
4. 权限申请：通讯录、审批、文档等 API 权限提交审批
5. 开发调试：
   • 服务端：调用 OpenAPI，接收事件推送
   • 客户端：H5/WebApp、Bot、Block 开发调试工具
6. 测试：使用测试企业租户验证功能、权限边界
7. 发布上线：内部应用直接发布；商店应用提交平台审核

五、官方开发工具与资源

1. 开发文档中心：https://open.feishu.cn/document 包含 API 手册、代码示例、最佳实践、故障排查
2. 调试工具
   • 卡片搭建工具：拖拽生成交互消息卡片
   • 日志检索：查询 API 调用报错、事件推送记录
   • 测试租户：独立隔离环境，不影响正式企业数据
3. 多语言 SDK：Java/Python/Go/Node.js/.NET，封装鉴权、请求逻辑
4. 开放平台智能助手：输入业务场景，自动提供接口方案 + 示例代码

六、典型落地场景案例

1. 系统打通：运维监控系统告警通过 Bot 推送飞书群，一键查看故障工单
2. 统一审批：ERP 采购流程同步飞书审批，审批结果回写业务系统
3. 单点登录 SSO：企业后台支持飞书扫码免登，统一身份体系
4. 数据协作：业务报表写入多维表格，文档内嵌业务看板 Block
5. 自动化办公：机器人定时抓取业务数据，生成日报卡片推送部门群
6. ISV 商用：CRM、项目管理、费控 SaaS 上架飞书市场，一键安装即用

七、与飞书低代码「妙搭」区别

• 飞书开放平台（全代码）：面向后端 / 前端开发者，自由调用全量 API，适配复杂系统集成、深度定制
• 飞书妙搭（低代码）：面向业务人员，可视化拖拽搭建简单表单、流程，无复杂 API 调用能力

官方入口

• 开放平台主页：https://open.feishu.cn
• 开发者文档：https://open.feishu.cn/document
• 开发者后台：登录后创建、管理应用、查看权限与日志