我们激动地宣布 TopBridge SDK 正式上线。JS Core 现已发布到 npm，React 和 Next.js 包装器即将推出。这是我们开发者社区期待已久的时刻——TOPSALE 标签打印，现在可以直接嵌入到您自己的应用程序中。
什么是 SDK 集成？
SDK 集成是指将某个功能——在这里是专业的标签打印——直接嵌入您自己的软件。无需让用户离开您的应用、登录到另外的门户、再在那里打印标签，而是把打印按钮直接放到您的界面里。使用 TopBridge SDK，开发者只需几行代码就可以把浏览器连接到本地 TSPL 或 ZPL 打印机、运行 preflight 预检、获取标签模板、触发打印任务——全程不需要离开页面。
为什么用 SDK 而不是 Self-Service 门户？
- 原生的用户体验。您的用户直接在您的应用内打印标签——无需切换上下文，无需跳转门户。
- 程序化控制。从软件中任意事件触发打印任务：订单确认、运单生成、批次完成。无需人工介入。
- 开箱即用的生产级。SDK 自带结构化错误类型、preflight 编排（健康检查 → 配额校验 → 打印机发现）、TopBridge 托盘应用的自动启动与重试、以及包含来源验证和输入净化的安全模型。
- 零外部依赖。纯浏览器原生 API。
npm install即可使用。
谁需要集成 SDK？
- SaaS 平台——用户在更大工作流的一部分中打印标签：ERP、WMS、电商后台、制造系统等。
- 内部工具——已经在使用 TOPSALE 的团队，希望在自己的仪表盘里暴露标签打印能力。
- 市场和集成商——希望提供标签打印作为产品功能，而无需自己构建打印机适配层。
- 任何人——已经厌倦了”打开门户、打印、回到原应用”的体验，希望实现原生应用内工作流。
从哪里开始
- TopBridge SDK 概览——功能介绍、代码示例、以及在 TOPSALE 免费试用。
- SDK 入门指南——完整的安装方法、API 参考与代码示例。
- 在线 Playground——直接在浏览器中体验 SDK，无需任何配置。
- npm 包——使用
npm install @appzgatenz/label-print-topbridge-js安装。 - Playground 源码 (GitHub)——Demo 完全开源,查看完整集成代码。
TopBridge SDK 与 TOPSALE 自家 Self-Service 门户共享同一个引擎——现在向您开放，让您在它的基础上构建。期待看到您用它做出什么。