抖音小程序开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_d292cff3/douyin-miniprogram-dev。
技能介绍
解决哪些工程痛点
在抖音(字节跳动)小程序开发中,从后端 API 联调到前端支付闭环,开发者常面临 API 封装不统一、合规要求复杂、核心业务代码重复编写等问题。本技能针对这些具体工程痛点,提供结构化的开发指导与开箱即用的代码资产,帮助团队快速落地云函数、担保支付、隐私授权等复杂业务场景,避免在基础架构和合规细节上反复试错。
核心能力与使用流程
技能将开发任务拆解为 7 个核心模块,每个模块均配有详细的 references/xxx.md 参考文档。使用时建议遵循以下流程:
- 识别模块:根据需求匹配对应场景,如“接入支付”对应支付订单系统。
- 加载文档:读取参考文档获取 API 细节与注意事项。
- 复用模板:在
assets/templates/下使用现成代码,例如带拦截器的request-wrapper.js,或覆盖完整支付链路的payment-flow.js。 - 辅助脚本:利用
scripts/下的gen_api_client.js自动生成 API 客户端,或使用validate_cloud_config.js校验云环境配置。
适用边界与关键注意事项
在集成前,请确保基础库版本不低于 2.x,并在开放平台正确配置 request、socket 等合法域名。需要注意的是,自 2023 年 9 月起,隐私授权弹窗已成为强制合规要求,未通过审核将无法发布。此外,担保支付功能仅支持企业主体,个人开发者暂无法调用。代码层面,建议遵循统一的 { code: 0, data: {}, message: '' } 响应格式,并注意抖音小程序使用 tt 命名空间(如 tt.request、tt.cloud.callFunction),以区别于微信生态的 wx 接口。
使用场景
- 后端接口联调:将多个REST API接入tt.request封装,统一鉴权、错误重试与Token刷新。
- 云函数开发:编写并部署tt.cloud云函数,完成数据库读写、事件触发与本地调试。
- 担保支付闭环:创建订单、调起tt.pay、验证回调,并处理退款与异常订单状态。
- 合规上线前自检:接入隐私授权弹窗与用户协议入口,校验合规清单并记录同意状态。
适合人员
- 小程序前端工程师:需要封装网络请求、接入支付与会员付费墙的工程师
- 后端/云开发工程师:负责云函数部署、回调处理与数据同步的工程师
- 独立开发者/项目Owner:要快速搭起合规弹窗与付费订阅闭环的个人开发者
- 技术负责人/架构师:制定错误码规范与API响应格式、管理云开发环境的技术负责人