API 概览：用代码控制标签

阿标提供完整的 REST API，可以用代码完成所有操作——模板管理、数据填充、批量打印。这是系统集成的基础。

API 基础知识

如果你没用过 API，可以这样理解：API 就是「程序之间的对话方式」。你在网页上点按钮做的事，用代码也能做——而且可以自动化、批量做。

API 地址和认证

• 网页版：https://www.ebarcode.cn/api

• 本地部署：http://localhost:5054/api

所有 API 需要 JWT Token 认证。先调登录接口获取 Token：

curl -X POST https://www.ebarcode.cn/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"123456"}'

# 返回
{"token":"eyJhbGci...","username":"admin","tenantId":"..."}

后续请求带上 Token：

curl https://www.ebarcode.cn/api/templates \
  -H "Authorization: Bearer eyJhbGci..."

核心 API 列表

• POST /api/auth/login —— 登录获取 Token

• GET /api/templates —— 获取模板列表

• GET /api/templates/{id} —— 获取模板详情

• POST /api/templates —— 创建模板

• PUT /api/templates/{id} —— 更新模板

• DELETE /api/templates/{id} —— 删除模板

• POST /api/print/preview —— 打印预览（返回 PNG 图片）

• POST /api/print/send —— 发送打印任务

实战示例：用 JavaScript 触发打印

// 1. 登录获取 Token
const loginResp = await fetch('/api/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ username: 'admin', password: '123456' })
});
const { token } = await loginResp.json();

// 2. 发送打印任务
await fetch('/api/print/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + token,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    templateId: 'f204d40f-...',
    printerName: 'Zebra_TLP2844',
    variables: {
      '名称': '不锈钢垫片 M8',
      '批号': 'B20250101'
    }
  })
});