TopBridge SDK の正式リリースをお知らせします。JS Core が npm で公開され、React と Next.js のラッパーは近日提供予定です。開発者コミュニティが待ち望んでいた瞬間です ── TOPSALE のラベル印刷を、皆様のアプリケーションに直接組み込めるようになりました。
SDK 統合とは？
SDK 統合とは、ある機能 ── ここでは本格的なラベル印刷 ── を、皆様自身のソフトウェアに直接組み込むことです。ユーザーをアプリから離脱させ、別のポータルにログインさせてラベル印刷させる代わりに、印刷ボタンをそのまま皆様の UI に置きます。TopBridge SDK を使えば、開発者は数行のコードでブラウザをローカルの TSPL/ZPL プリンターに接続し、preflight チェックを実行し、ラベルテンプレートを取得し、印刷ジョブをトリガーできます ── ページを離れる必要は一切ありません。
セルフサービスポータルではなく SDK を使う理由
- ネイティブなユーザー体験。ユーザーは皆様のアプリ内から直接ラベルを印刷します ── コンテキスト切替なし、ポータル間移動なし。
- プログラム的な制御。ソフトウェア内の任意のイベントから印刷ジョブをトリガー：注文確定、出荷生成、バッチ完了など。ユーザー介在は不要です。
- すぐに本番投入可能。SDK には構造化エラータイプ、preflight オーケストレーション（ヘルスチェック → クォータ検証 → プリンタ検出）、TopBridge トレイアプリの自動起動とリトライ、オリジン検証と入力サニタイズを含むセキュリティモデルが標準搭載されています。
- 外部依存ゼロ。ブラウザネイティブな API のみ。
npm installで即利用可能。
SDK を統合すべき方
- SaaS プラットフォーム ── より大きなワークフローの一部としてユーザーがラベルを印刷する場合：ERP、WMS、EC バックエンド、製造システム等。
- 社内ツール ── 既に TOPSALE を使うチームで、自社ダッシュボード内にラベル印刷機能を露出させたい場合。
- マーケットプレイス・インテグレーター ── プリンタ層をゼロから構築せずに、ラベル印刷を機能として提供したい場合。
- すべての方 ──「ポータルを開く、印刷する、戻る」体験の限界に達し、ネイティブなアプリ内ワークフローを実現したい方。
はじめに
- TopBridge SDK 概要 ── 機能、コード例、TOPSALE の無料トライアル登録。
- SDK スタートガイド ── 完全なインストール手順、API リファレンス、コード例。
- ライブ Playground ── ブラウザで直接 SDK を体験。セットアップ不要。
- npm パッケージ ──
npm install @appzgatenz/label-print-topbridge-jsでインストール。 - Playground ソース (GitHub) ── Demo はオープンソース、完全な統合コードを確認できます。
TopBridge SDK は TOPSALE 自身のセルフサービスポータルを動かしているのと同じエンジン ── 今、皆様の上に構築するために開放されました。皆様が何を作り上げるか、楽しみにしています。