我們興奮地宣布 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 入口共享同一個引擎——現在向您開放，讓您在它的基礎上建構。期待看到您用它做出什麼。