API V2

向 PDF 添加条形码

使用我们强大的条形码API,为您的PDF文档添加超过150种条形码类型,包括二维码、Code128、DataMatrix、Aztec、Hanxin和PDF417。非常适合库存系统运输标签文档跟踪自动化工作流程

主要功能:

  • 150+条形码类型:二维码、Code128、DataMatrix、Aztec、Hanxin、PDF417等
  • 灵活定位:可将条形码精确放置在PDF任意位置
  • 多种格式:支持毫米和点单位,精确尺寸控制
  • 文本显示选项:显示或隐藏条形码文本,可上下定位
  • 透明度控制:调整透明度以实现水印效果
  • 批量处理:可为多页或多文档添加条形码

常见应用场景:

  • 电商:带条形码标签的产品目录
  • 物流:运输标签和跟踪文件
  • 医疗:病人记录和药物管理
  • 政府:身份证件和合规表单
  • 教育:学生证和图书馆系统

条形码生成API可无缝集成到您的现有工作流程,提供企业级的可靠性和性能。

  • 方法: POST
  • 端点: /api/v2/addbarcode

验证您的 API 请求

要访问 PDF4me Web API,每个请求都必须包含适当的身份验证凭据。身份验证确保安全通信并验证您作为授权用户的身份。


支持的条形码类型

我们的条形码生成器API支持150多种条形码类型,是PDF条形码集成最全面的解决方案。

1D条形码(线性)

  • Code128:最通用的1D条形码,支持所有ASCII字符
  • Code39:字母数字条形码,广泛用于物流
  • EAN13/EAN8:国际零售产品识别
  • UPC-A/UPC-E:北美零售标准
  • Code93:Code39的增强版本,密度更好

2D条形码(矩阵)

  • 二维码:最受欢迎的2D条形码,用于移动扫描
  • DataMatrix:高密度2D条形码,完美适用于小物品
  • PDF417:堆叠线性条形码,数据容量大
  • Aztec:2D条形码,具有出色的错误纠正功能
  • Hanxin:中国国家标准2D条形码

PDF4me api samples

CSharp(C#)
Java
JavaScript
Python
Salesforce
Google Script
AWS Lambda

API 参数

Add Barcode to PDF API 的完整参数列表。参数按类别组织,便于理解和实现。

文档内容Base64, Required

以Base64格式编码的PDF文档内容。这是将添加条形码的源PDF文件。文件必须是有效的PDF文档。

示例:JVBERi0xLjQKJcOkw7zDtsO8CjIgMCBvYmoKPDwKL0xlbmd0aCAzIDAgUgo+PgpzdHJlYW0K...

文档名称string, Required

源PDF文件的名称。必须包含.pdf扩展名。此名称将用于参考,并可能出现在错误消息中。

示例:

  • document.pdf
  • invoice-2024.pdf
  • report-final.pdf
条形码数据string, Required

要编码到条形码中的数据。可以是文本、数字、URL或所选条形码类型支持的任何字符串。数据将转换为可扫描的条形码图像。

示例:

  • 文本:Hello World
  • URL:https://example.com
  • 产品代码:ABC123456
  • 电话:+1-555-123-4567

注意: 不同的条形码类型有不同的数据容量限制和字符限制。

条形码类型string, Required

指定要生成的条形码类型。从150多种支持的条形码格式中选择,包括二维码、线性条形码和2D矩阵码。

热门类型:

  • 二维码:qrCode - 最通用的2D条形码
  • Code128:code128 - 通用1D条形码
  • DataMatrix:dataMatrix - 高密度2D条形码
  • EAN13:ean13 - 国际产品代码
  • UPC-A:upcA - 北美零售标准

请参阅上面支持的条形码类型完整列表以获取所有可用选项。

目标页面string, Required

指定哪些页面应添加条形码。使用逗号分隔的值和范围的灵活页面选择。

格式示例:

  • 所有页面:""(空字符串)
  • 单个页面:"0"(第一页)
  • 多个页面:"0, 2, 4"
  • 页面范围:"1-5"(第2-6页)
  • 混合:"0, 2-4, 7"(第1页,第3-5页,第8页)
  • 从页面到结尾:"3-"(第4页到结尾)

注意: 页面索引从0开始(第一页=0)。如果未指定,条形码将添加到所有页面。

水平对齐string, Required

控制条形码在页面上的水平位置。这决定了条形码相对于页面边距的水平位置。

选项:

  • Left - 对齐到页面左边缘
  • Center - 在页面上水平居中
  • Right - 对齐到页面右边缘

示例:"Center" 将在页面中间水平放置条形码。

垂直对齐string, Required

控制条形码在页面上的垂直位置。这决定了条形码相对于页面边距的垂直位置。

选项:

  • Top - 对齐到页面上边缘
  • Middle - 在页面上垂直居中
  • Bottom - 对齐到页面下边缘

示例:"Bottom" 将在页面底部垂直放置条形码。

条形码高度(毫米)string, Required

设置条形码的高度(毫米)。这控制生成的条形码的垂直尺寸。

推荐高度:

  • 二维码: 20-60mm(推荐40mm)
  • 1D条形码: 15-30mm(推荐20mm)
  • DataMatrix: 10-40mm(推荐20mm)

自动调整大小: 输入 "0" 让系统根据条形码类型和数据自动确定最佳高度。

示例:"40" 创建一个40mm高的条形码。

宽度(毫米)string, Required

条形码的宽度(毫米)。输入 ‘0’ 进行自动检测。
示例 - 40.

水平边距(毫米)string, Required

条形码左侧原点与左侧边缘的距离(毫米)
示例 - 20

垂直边距(毫米)string, Required

条形码顶部原点与顶部边缘的距离(毫米)
示例 - 20

高度(点)String, Required

条形码的高度(点)。输入 ‘0’ 进行自动检测。
示例 - 20.

宽度(点)String, Required

条形码的宽度(点)。输入 ‘0’ 进行自动检测。
示例 - 20.

X边距(点)String, Required

条形码顶部原点与顶部边缘的距离(点)。
示例 - 10.

Y边距(点)String, Required

条形码左侧原点与左侧边缘的距离(点)。
示例 - 10.

不透明度integer, Required

输入 0 到 100 之间的值,其中 ‘0’ 完全透明。
示例 - 100.

显示文本String, Required

文本将显示在条形码上方 -
上方
下方

隐藏文本Boolean, Required

选择 ‘true’ 隐藏条形码的文本,选择 ‘false’ 与条形码一起显示。

  • true
  • false
仅在打印时显示Boolean, Required

如果您想 仅在打印时显示,仅在打印时显示。您可以在这两个选项中选择。
true
false

文本是否在上方Boolean, Required

如果您想 文本是否在上方,您可以在这两个选项中选择。
true
false


输出

API返回带有嵌入条形码的处理后PDF文档。响应包括文件内容和元数据,便于集成到您的应用程序工作流中。

文件内容Binary

带有嵌入条形码的处理后PDF文档的二进制内容。准备下载或进一步处理。

文件名String

处理后PDF文档的文件名。可以根据您的要求进行自定义或自动生成。

请求头
Content-Type: application/json
Authorization: 请从链接复制密钥。

Payload

{
  "alignX": "Right",
  "alignY": "Top",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "text": "hello",
  "barcodeType": "qrCode",
  "pages": "2",
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "20",
  "widthInPt": "20",
  "marginXInPt": "10",
  "marginYInPt": "10",
  "opacity": 100,
  "displayText": "above",
  "hideText": true,
  "showOnlyInPrint": false,
  "isTextAbove": true
}

行业用例和应用

电子商务和零售

  • 产品目录:为库存管理和产品识别生成条形码
  • 价格标签:创建动态定价,集成条形码实现自动结账
  • 订单跟踪:在运输文档中添加跟踪代码,实现实时包裹监控
  • 库存系统:为仓库管理和库存控制进行批量条形码生成

物流和运输

  • 运输标签:在交付文档中添加跟踪条形码,实现包裹可追溯性
  • 包裹跟踪:为供应链中的每个运输生成唯一标识符
  • 仓库管理:为仓位和产品识别创建条形码
  • 供应链:通过嵌入代码在整个分销网络中跟踪产品

医疗保健和医学

  • 患者记录:添加条形码实现快速患者识别和医疗历史访问
  • 药物管理:生成条形码用于药物跟踪和剂量验证
  • 医疗设备:用维护条形码标记设备进行资产管理
  • 实验室结果:在测试结果文档中添加条形码,实现安全的患者数据链接

政府和合规

  • 身份证件:在驾照和护照中添加安全条形码进行验证
  • 税务文档:为税务表格和合规监控生成跟踪代码
  • 合规表格:添加条形码用于监管跟踪和审计轨迹
  • 公共记录:为政府数据库创建可搜索的文档标识符

教育和图书馆

  • 学生证:生成条形码用于学生识别和校园访问控制
  • 图书馆系统:在书籍和资源中添加条形码,实现自动借阅系统
  • 考试试卷:为测试文档和学术诚信创建唯一标识符
  • 校园服务:在教育设施中跟踪设备和资源使用情况

商业和金融

  • 发票处理:添加条形码实现自动发票处理和支付处理
  • 文档管理:为商业文档和记录创建唯一标识符
  • 资产跟踪:为组织中的设备和资产生成条形码
  • 审计轨迹:为合规文档和财务记录添加跟踪代码