メインコンテンツへスキップ
PDF4me API統合AIとSDK知識ベース拡張機能APIテスターブログ

バーコードを追加する PDF - QR Code 統合 API

PDF4me バーコードを追加する PDF プロフェッショナルなバーコードを追加できます。 QR codes に PDF 正確な位置、サイズ、書式設定制御を備えたドキュメント。 API サービスプロセス PDF ファイルとバーコードを追加 Base64 安全な送信のためのエンコード。150種類以上のバーコードタイプをサポート。 QR codes、 Code128、 DataMatrix、 Aztec、 Hanxin、 PDF417また、特殊なフォーマットにも対応しており、このソリューションは在庫管理システム、配送ラベルの自動化、文書追跡ワークフロー、および企業バーコード統合に最適です。

関連ブログ記事(1)

認証 API リクエスト​

アクセスするには PDF4me REST APIすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、あなたが正規のユーザーであることが検証されます。 REST API。

Get your api Key

主な機能​

  • 包括的なバーコードサポート: 150種類以上のバーコードタイプを含む QR codes、 Code128、 DataMatrix、 Aztec、 Hanxin、 PDF417郵便番号、および業界特有のフォーマット
  • 精密な位置決め制御バーコードをどこにでも配置 PDF ミリメートルとポイントの両方の測定システムを使用して、ピクセル単位の精度でページを描画します。
  • 高度なサイズオプション: 自動サイズ調整機能とカスタム幅/高さ制御による柔軟なバーコード寸法で最適なスキャン性能を実現
  • プロフェッショナルなテキスト管理カスタマイズ可能な書式設定オプションを使用して、バーコードのテキスト表示、位置（上/下）、および可視性を設定します。
  • 不透明度と透明度透かし効果、ドキュメントオーバーレイ、プロフェッショナルなプレゼンテーションのために、バーコードの透明度レベルを調整します。
  • エンタープライズバッチ処理自動処理ワークフローを使用して、複数のページ、文書、または文書コレクション全体にバーコードを追加します。

REST API 終点​

の PDF4me REST API 標準を使用する HTTP リソースとやり取りするための方法。すべてのバーコード操作は単一のエンドポイントを介して実行されます。

  • 方法： POST
  • 終点： /api/v2/addbarcode

サポートされているバーコードの種類​

150種類以上のバーコードタイプをサポートし、包括的な PDF 統合。

人気の1次元バーコード​

  • Code128 - ユニバーサルバーコード（最大255文字）
  • Code39 英数字バーコード（最大43文字）
  • EAN13/EAN8 - 小売商品コード（13文字または8文字）
  • UPC-A/UPC-E - 北米小売（12/8文字）

人気の2次元バーコード​

  • QR Code - モバイルスキャン（最大4,296文字）
  • DataMatrix - 高密度2D（最大2,335文字）
  • PDF417 - 大容量データ（最大2,710文字）
  • Aztec - 優れたエラー訂正機能（最大3,832文字）

特殊フォーマット​

  • 郵便番号: USPS、 Royal Mail、 Australia Post、 Deutsche Post
  • 健康管理: HIBC、 GS1 DataBar、 Pharmacode
  • ロジスティクス: MaxiCode、 SSCC-18、 ITF-14、 GS1-128
  • QRコードのバリエーション: Micro QR、 iQR、 rMQR

REST API パラメータ​

バーコードを追加する際のパラメータの完全なリスト PDF REST APIパラメータは、理解と実装を容易にするためにカテゴリ別に整理されています。

重要： アスタリスク (*) が付いているパラメータは必須であり、提供する必要があります。 API 正しく機能するため。

パラメータ必須その機能例
jobIdExtOptionalYour own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string.
integrationsOptionalIntegration identifiers, forwarded unchanged with the job's notification settings. Type: array.
isAsyncOptionalSet to `true` to process the action asynchronously and get a job to poll at `/api/v2/GetActionStatus`. Only honoured by actions that support asynchronous processing. Type: boolean.true
docNameOptionalSource file name including its extension. Several actions dispatch on the extension, so it should always be set; when omitted a per-action default is used. Type: string.output.pdf
docContentRequiredThe source file. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference to a previously uploaded blob, or an `https` URL to the source document. Required: an empty value fails with `File is empty`. Type: string.JVBERi...
docContentBytesOptionalAlternative raw byte payload for the source file. Type: string.
callBackUrlOptionalOptional URL notified when an asynchronous job completes. Type: string.
textOptionalRequired. Text to encode in the barcode. Type: string.PDF4me Barcode Sample
barcodeTypeOptionalAn unrecognised value is rejected with 400. Type: string.qrCode
alignXOptionalAn unrecognised value is rejected with 400. Type: string.Right
alignYOptionalAn unrecognised value is rejected with 400. Type: string.Bottom
heightInMMOptionalBarcode height in millimetres. When `heightInMM` or `widthInMM` is set it overrides the `...InPt` size; 0 or empty leaves the size to the service. Type: string.40
widthInMMOptionalBarcode width in millimetres. When `heightInMM` or `widthInMM` is set it overrides the `...InPt` size; 0 or empty leaves the size to the service. Type: string.40
heightInPtOptionalBarcode height in points (1/72 inch). Ignored when a millimetre size is given. Type: string.113
widthInPtOptionalBarcode width in points (1/72 inch). Ignored when a millimetre size is given. Type: string.113
marginXInMMOptionalHorizontal distance in millimetres from the edge chosen by `alignX`. Overrides `marginXInPt` when either millimetre margin is set. Ignored when `alignX` is `center`. Type: string.20
marginYInMMOptionalVertical distance in millimetres from the edge chosen by `alignY`. Overrides `marginYInPt` when either millimetre margin is set. Ignored when `alignY` is `middle`. Type: string.20
marginXInPtOptionalHorizontal distance in points from the edge chosen by `alignX`. Ignored when `alignX` is `center`. Type: string.57
marginYInPtOptionalVertical distance in points from the edge chosen by `alignY`. Ignored when `alignY` is `middle`. Type: string.57
opacityOptionalOpacity from `0` (invisible) to `100` (fully opaque); values outside the range are clamped. Omitted or non-numeric counts as `0`. Type: string.100
pagesOptionalPages to stamp, e.g. `1`, `1,3,5`, `2-5`, `2-` (2 to the last page) or `all`. Type: string.1-3
hideTextOptionalHide the human-readable text under or above the barcode. Type: boolean.true
showOnlyInPrintOptionalShow the barcode only when the PDF is printed, not on screen. Type: boolean.false
displayTextOptionalWhere to show the human-readable text, `above` or `below` the barcode. Type: string.below
isTextAboveOptionalShow the human-readable text above the barcode instead of below it. Type: boolean.false

出力​

の PDF4me バーコードを追加する PDF REST API 処理モードに基づいて異なる応答を返します。 API 返します PDF として Base64-エンコードされた文字列 JSON フォーマットバイナリデータとしてではなく。

同期処理（デフォルト）

いつ async 設定されていないか、 false、 API リクエストを即座に処理します。

ステータスコード: 200 OK

Content-Type: application/json

応答本文：

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

回答欄:

  • docName （文字列）：出力 PDF ファイル名
  • docContent (文字列): PDF バーコードが追加されたファイル、エンコードされた Base64 弦

使用方法：

  1. 抽出する docContent からのフィールド JSON 応答
  2. 解読する Base64 バイナリを取得する文字列 PDF データ
  3. 保存または処理 PDF 必要に応じてファイルする

例 （JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

リクエスト例​

ヘッダ​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

注記：

  • 手に入れよう API 鍵から PDF4me ダッシュボード
  • の API キーは Base64 エンコードされ、「Basic」がプレフィックスとして付加されています。 Authorization ヘッダー
  • 例: API 重要なのは abc123エンコードして Base64 そして使用する Authorization: Basic YWJjMTIz

ペイロード​

基本的な例（必須項目のみ）：

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "text": "PDF4me Barcode Sample",
  "barcodeType": "qrCode",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "hideText": true
}

高度な例（すべてのオプションフィールドを含む）：

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "text": "PDF4me Barcode Sample",
  "barcodeType": "qrCode",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "hideText": true,
  "heightInMM": "40",
  "widthInMM": "40",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "heightInPt": "113",
  "widthInPt": "113",
  "marginXInPt": "57",
  "marginYInPt": "57",
  "opacity": 100,
  "displayText": "below",
  "showOnlyInPrint": false,
  "isTextAbove": false,
  "async": true
}

コードサンプル​

の PDF4me バーコードを追加する PDF REST API 複数のプログラミング言語のコードサンプルを提供します。開発環境に最適な言語を選択してください。

C# （CSharpサンプル

完了 C# バーコードを追加するための実装 PDF 文書:

業界におけるユースケースとアプリケーション​

Eコマースおよび小売業における活用事例

  • 製品カタログ在庫管理および製品識別のためのバーコードを生成する
  • 値札バーコード統合による動的な価格設定で自動チェックアウトを実現します
  • 注文追跡リアルタイムで荷物を追跡できるよう、配送書類に追跡コードを追加する
  • 在庫管理システム倉庫管理と在庫管理のためのバーコードの一括生成

ヘルプが必要な場合​

Get Your API KeyAPI SamplesGetting Started