条形码生成器 API：1 个 POST、SVG 输出、六种格式

您的仓库应用程序打印运输标签。 每个标签都需要一个 Code128 条形码用于跟踪 数量。 您可以安装条形码库、渲染到画布、导出为 PNG 并将其嵌入到 您的标签模板。 或者您可以发送一个 POST 并返回一个 SVG。

波托伊 /v1/barcode 端点将数据编码为六种条形码格式并返回 JSON 响应中的 SVG 字符串。 没有 npm 包。 没有构建步骤。 没有画布依赖性。

API 调用

发送带有数据和格式的 POST 请求：

响应将 SVG 包装在标准 JSON 信封中：

提取 svg 字段，将其放入 <img> 标签，内联它 在 HTML 中，或通过管道将其传输到文件。 SVG 在任何尺寸下都能清晰呈现，因为它是基于矢量的； 在 300 DPI 或更高的分辨率下没有光栅化伪影。

参数

端点接受五个参数。 仅有的 data 是必须的：

• 数据 （字符串，必需）：要编码的值。 对于 EAN-13，传递 13 位数字。 对于 Code128，传递任何可打印的 ASCII 字符串。
• 格式 （字符串，默认 code128）：其中之一 code128, ean-13, ean-8, upc-a, itf-14， 或者 msi。
• 宽度 （数字，默认 200）：图像宽度（以像素为单位）。 范围：50 至 2000。
• 高度 （数字，默认 80）：图像高度（以像素为单位）。 范围：20 至 1000。
• 显示文本 （布尔值，默认值 true): 是否渲染 编码值作为条形下方的文本。

这是一个设置了所有参数的 Code128 条形码：

实际例子

运输标签生成

将装箱单和运输标签的追踪号码编码为 Code128。 Code128手柄 混合字母数字字符串，因此像“1Z999AA10123456784”这样的跟踪号码无需 预处理。

库存管理系统

打印仓库箱和货架的 Code128 标签。 工作人员用手持阅读器扫描它们 在分拣和包装过程中。 条形码对完整的位置路径进行编码：仓库、货架、箱子。

零售产品标签 (EAN-13)

EAN-13 是零售产品的国际标准。 传递 13 位 GTIN 和 API 返回尺寸适合标准货架边缘标签的 SVG。

产品目录的 Node.js 批量生成

并行生成整个产品目录的条形码。 该脚本触发四个请求 同时收集 SVG 字符串：

输出：

对于包含数百种产品的目录，请以 20-50 为一组进行批处理，以保持在速率限制之内。 免费套餐上限为每分钟 5 个请求； API 密钥消除了该限制。

Node.js 示例：用于订单履行的条形码标签

这个 Express 服务器公开了一个 /labels/:orderId 端点。 当你的成就感 系统或标签打印机获取此 URL，它会返回编码订单的 SVG 条形码 追踪号码。

用法：

24小时缓存头可以防止同一订单的重复API调用。 在生产中， 在此路由前面添加 CDN 或 Redis 缓存。

何时使用哪种格式

Code128 是默认值是有原因的：它编码最广泛的字符并且适用于 大多数内部系统。 当您的产品需要零售扫描时，切换到 EAN-13 或 UPC-A 条形码。 使用ITF-14作为物流外箱标签。 MSI 适合仓库货架标签 您需要带有简单校验位的纯数字代码。

要点

每分钟 5 个请求的免费套餐涵盖开发、测试和小批量标签 印刷。 对于批量生成或高流量履行系统，请在 Authorization: Bearer 标头。 检查 API文档 获取完整的端点参考。