飞书小程序

飞书小程序#

平台概述#

飞书小程序运行在飞书客户端内，面向 企业内部协同 场景，依托飞书的通讯录、消息、日历、文档、审批、多维表格等企业能力。适合企业工具、内部系统、办公自动化。

⚠️ 形态选择：飞书当前的「小程序」（TTML/TTSS）已标记为 不推荐，官方推荐新项目使用 网页应用（H5 + h5sdk JSAPI），开发更灵活、生态更新。下文同时覆盖两种形态。

核心优势：

企业能力丰富：通讯录、消息、日历、文档、审批全打通
免登：飞书内自动获得用户身份，无需独立登录
跨端运行：Android / iOS / PC 一套代码
机器人 + 卡片消息：强大的消息触达与交互

典型场景：

企业工具：HR 系统、CRM、项目管理
审批/流程：请假、报销、采购审批
数据看板：多维表格、报表
办公协同：日程、待办、会议

设计规范#

技术模型#

小程序形态：.ttml（TTML 模板）+ .ttss（TTSS 样式）+ .js，类微信/抖音
网页应用形态（推荐）：标准 H5 + 引入 h5sdk，通过 JSAPI 调用飞书原生能力
事件绑定用 bindtap（类微信）

尺寸单位#

支持 rpx：750rpx = 屏幕宽度（类微信）

跨端#

支持在 Android、iOS、PC 客户端运行
PC 端需额外适配交互与尺寸

审核规范#

自建应用 vs 应用市场#

自建应用：企业内部使用，免审直接发布
应用市场分发：面向所有飞书租户，需通过飞书审核

常见要求#

权限最小化：申请的通讯录/消息等权限需与功能匹配
数据合规：用户数据使用需符合企业隐私规范
企业主体：通常需企业管理员授权安装

开发指南#

快速上手（H5 网页应用，推荐）#

code

<!-- 引入 h5sdk -->
<script src="https://lf1-cdn-tos.bytegoofy.com/goofy/lark/op/h5-js-sdk-1.5.20.js"></script>
<script>
  // 免登：用服务端 code 换用户身份
  window.h5sdk.ready(() => {
    window.tt.scanCode({
      scanType: ['qrCode'],
      success: (res) => console.log('扫码结果', res.result)
    })
  })
</script>

服务端调用（飞书开放平台）#

code

// Node.js SDK：创建 API Client 后用 client.业务域.资源.方法 调用
await client.im.message.create({
  data: { msg_type: 'text', content: 'Hello 飞书' }
})
await client.contact.user.list({ params: { department_id: 0 } })

常见陷阱#

小程序形态不推荐：新项目建议用网页应用（H5 + h5sdk），生态更新、更灵活
权限申请：调用通讯录/消息/日历等需在应用后台申请对应权限范围并经管理员授权
多 token 体系：区分 tenant_access_token（租户）与 app_access_token（应用）
免登流程：前端拿 code → 服务端 jscode2session 换 user_info/openid
API 命名：客户端 JSAPI 的具体方法名以飞书「H5 JSAPI 总览」为准（部分与抖音 tt.* 相似但存在差异）

工具	说明
飞书开发者工具	小程序/网页应用开发与调试
飞书开放平台 SDK	Node.js / Python / Go，调用服务端 API
h5sdk	网页应用 JSAPI

特性

详细文档

飞书小程序#

平台概述#

设计规范#

技术模型#

尺寸单位#

跨端#

审核规范#

自建应用 vs 应用市场#

常见要求#

开发指南#

快速上手（H5 网页应用，推荐）#

服务端调用（飞书开放平台）#

常见陷阱#

生态资源#

推荐框架/工具#

社区资源#

版本更新#

近期重要变更#