통합

개발자 SDK

브라우저에서 프린터까지, 하나의 브릿지로 — 모든 웹 앱을 위한 헤드리스 라벨 인쇄 SDK

TopBridge SDK는 라벨 인쇄를 웹 애플리케이션에 직접 임베드할 수 있는 헤드리스 브라우저 네이티브 라이브러리입니다. JS Core는 현재 npm에 출시되었습니다; React 및 Next.js 래퍼는 곧 출시될 예정입니다.

처음부터 프로덕션을 위해 설계되었습니다: 외부 의존성 제로, 한 줄 호출의 preflight 오케스트레이션 (헬스 체크 → 할당량 검증 → 프린터 검색), instanceof 타입 좁히기를 지원하는 10가지 구조화된 오류 유형, TopBridge 트레이 앱의 자동 실행 + 재시도 메커니즘, 고정 연결 엔드포인트·출처 검증·입력 정화·빌드 시 난독화를 포함하는 보안 모델.

npm 패키지: @appzgatenz/label-print-topbridge-js — npm install @appzgatenz/label-print-topbridge-js로 직접 설치하세요.

SDK 문서 및 도움말: 설치 방법, API 참조 및 코드 예제는 SDK 시작 가이드를 참조하세요.

로컬 설치를 원하지 않으세요? 브라우저에서 직접 SDK를 체험할 수 있는 라이브 Playground를 사용해 보세요 —— 설정 불필요.

GitHub 소스: Playground demo는 오픈소스입니다 — 전체 통합 코드는 github.com/youngming/label-print-topbridge-js-SDK-demo에서 확인하세요.

example.ts

import { TopBridgeClient } from '@appzgatenz/label-print-topbridge-js';

const client = new TopBridgeClient();

// Preflight: health check → quota → printer discovery
const { printers } = await client.preflight.run();

// Print a label
await client.print.execute({
  template: 'PRICE_LABEL',
  printer:  'TSC DA220',
  products: [
    { name: 'Apple', price: 3.99, copies: 2 },
  ],
});