Sheets To Labels
无需 API Key,直接生成带水印的真实 PDF

标签生成 API,直接输出可打印 PDF

标签只需设计一次,后端提交 JSON 数据后即可获得已完成标签纸或热敏排版的 PDF。适合商品标签、条码贴纸、二维码卡片、资产标签、活动证件和持续运行的打印流程。

公开 Demo 无需注册。生产环境 API 需要有效的 Business 订阅。

不只是返回一张条码图片

普通条码 API 通常只返回 PNG 或 SVG。SheetsToLabels 会把文字、条码、二维码、品牌样式、打印数量和纸张排版组合成一份可直接打印的 PDF。

标签纸排版

每次请求可以选择受支持的标签纸预设,或提交纸张、行列、页边距和标签间距。

热敏标签输出

使用一页一张标签的模板,通过驱动打印到 Zebra、Rollo、Dymo、Brother 等热敏打印机。

条码与二维码数据

可将 SKU、序列号、网址、推荐码或其他记录字段绑定到条码和二维码元素。

按记录设置份数

使用 records[].copies 让相同标签连续排列,无需在业务系统中复制原始数据。

后端工作流

四步生成可打印 PDF

编辑器负责单张标签或卡片设计,后端负责选择打印排版并提交每次变化的数据。

1

设计标签

在可视化标签编辑器中添加文字、条码、二维码、形状和图片。

2

选择打印排版

在 API 请求中选择单张输出、Avery 或 APLI 预设,或者提交完整的自定义网格。

3

提交 JSON 记录

后端使用 Template ID 和一条或多条记录调用 POST /api/v1/generate-pdf。

4

接收 PDF

成功响应就是 PDF 文件,可直接下载、保存、邮件发送或交给后续打印流程。

为标签、卡片和重复打印任务设计

同一个接口既可以生成一份个性化文件,也可以把一批记录排进同一份 PDF。

在请求中选择受支持的预设;API 会先核对标签尺寸,再按照预设把记录排列到标签纸上。

专注于生产环境标签工作流

单张标签设计与每次 PDF 请求所选择的打印排版彼此独立。

单条与批量使用同一协议

无论生成一个还是一批标签,都使用相同的 templateId 和 records 结构。

直接返回 PDF

成功请求立即返回 application/pdf,无需轮询托管文件任务。

清晰的 JSON 错误

失败时返回 application/problem+json,包含稳定错误码、说明、HTTP 状态和 Request ID。

按最终页数扣除 Credits

费用按照最终生成的 PDF 页数计算,而不是原始记录数或重复标签数量。

服务端鉴权

在可信后端使用 Bearer API Key,不要把 Key 放进浏览器代码或移动应用。

请求追踪与用量响应头

响应头会返回请求、记录、标签、页数、Credits 和限流等信息。

标签生成 API 常见问题

在开始接入前,先确认 API 是否符合你的打印流程。







还有其他问题吗?

如果您找不到想要的答案,请随时向我们咨询!

生成一份可直接打印的标签 PDF

先使用无需 Key 的 Playground 查看真实结果,准备接入自己的模板时再按照快速入门操作。

Business 月度和年度订阅包含生产环境 API 权限;单独购买一次性 Credit Pack 不会解锁 API。

标签生成 API - 输出可直接打印的 PDF 标签纸