バーコードを読み取る PDF - スキャナー&エクストラクター API
PDF4me バーコードを読み取る PDF さまざまな種類のバーコードを抽出および認識し、 QR codes から PDF 高度なドキュメントを使用する OCR そしてバーコード認識技術。 API サービスプロセス PDF ファイルからバーコードデータ(位置座標、タイプ情報、抽出テキストを含む)を抽出します。 API 受け取る PDF コンテンツを通じて REST API 通話を利用して Base64 安全な送信のためのエンコード。1Dおよび2Dバーコードをサポート。 QR codes、 DataMatrix、 PDF417、 Code128また、業界特有のフォーマットにも対応しており、このソリューションは文書処理、在庫管理、追跡システム、ワークフロー自動化に最適です。
認証 API リクエスト
アクセスするには PDF4me REST APIすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、あなたが正規のユーザーであることが検証されます。 REST API。
主な機能
- 包括的なバーコード認識: 1Dおよび2Dバーコードのサポート QR codes、 DataMatrix、 PDF417、 Code128郵便番号、および業界特有のフォーマット
- シームレス PDF 統合: 直接処理 PDF すべてのサポートを備えたドキュメント PDF バージョンと複雑な文書構造
- フレキシブルページ処理特定のページ、ページ範囲、または文書全体を、選択的なバーコード抽出機能で処理します。
- エンタープライズバッチ処理自動処理ワークフローを使用して、単一または複数のページから複数のバーコードを抽出します。
- 構造化データ出力: 構造化されたバーコードデータを返す JSON 位置座標、タイプ情報、メタデータを含むフォーマットで、システムへの統合が容易
サポートされているバーコードの種類
の API 信頼性の高い認識を実現するため、幅広いバーコードフォーマットに対応しています。
1次元バーコード
- Code128 - ユニバーサルバーコードフォーマット
- Code39 英数字バーコード
- Code93 高密度バーコード
- Codabar - 数字バーコード
- EAN8/EAN13 - 欧州商品番号
- UPC-A/UPC-E - ユニバーサルプロダクトコード
- Inter2of5 - 工業分野 2/5
- PatchCode - 文書処理コード
2次元バーコード
- QR Code - クイックレスポンスコード
- DataMatrix 高密度2次元バーコード
- PDF417 - ポータブルデータファイル
- MicroQRCode - コンパクト QR 変異体
特殊フォーマット
- 郵便番号: Postnet、 Planet、 RM4SCC、 Australia Post
- インテリジェントメール: USPS インテリジェントメールバーコード
- PharmaCode医薬品バーコード
- RSS Codes: 縮小空間シンボル
REST APIエンドポイント
の PDF4me REST API 標準を使用する HTTP リソースとやり取りするための方法。すべてのバーコード読み取り操作は、単一のエンドポイントを介して実行されます。
- 方法: POST
- 終点:
/api/v2/ReadBarcodes
REST APIパラメータ
バーコード読み取りのパラメータ一覧 PDF REST APIパラメータは、理解と実装を容易にするためにカテゴリ別に整理されています。
重要: アスタリスク (*) が付いているパラメータは必須であり、提供する必要があります。 API 正しく機能するため。
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| jobIdExt | Optional | Your own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string. | |
| integrations | Optional | Integration identifiers, forwarded unchanged with the job's notification settings. Type: array. | |
| isAsync | Optional | Set 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 |
| docName | Optional | Source 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. | document.pdf |
| docContent | Required | The 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... |
| docContentBytes | Optional | Alternative raw byte payload for the source file. Type: string. | |
| callBackUrl | Optional | Optional URL notified when an asynchronous job completes. Type: string. | |
| barcodeType | Optional | Barcode types to look for, e.g. `["qrCode"]` or `["dataMatrix","code128"]`. With one entry an unknown type is rejected with 400; with several, unknown entries are skipped. Empty or no valid entry searches all types. Type: array. | ["all"] |
| pages | Optional | Pages to scan, e.g. `all`, `1`, `1,3,5`, `2-5` or `2-` (2 to the last page). Type: string. | all |
出力
の PDF4me バーコードを読み取る PDF REST API 処理モードに基づいて異なる応答を返します。 API 構造化されたリターン JSON バーコード情報を含むデータ。
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
同期処理(デフォルト)
いつ IsAsync 設定されていないか、 false、 API リクエストを即座に処理します。
ステータスコード: 200 OK
Content-Type: application/json
応答本文:
{
"barcodes": [
{
"type": "qrCode",
"text": "Barcode content",
"page": 1,
"x": 100,
"y": 200,
"width": 50,
"height": 50
}
]
}
回答欄:
- バーコード (配列):検出されたバーコードオブジェクトの配列
- タイプ (文字列):バーコードタイプ(例:「qrCode「、」dataMatrix「、」code128")
- 文章 (文字列):抽出されたバーコードの内容/テキスト
- ページ (番号):バーコードが見つかったページ番号
- x (数値):バーコード位置のX座標
- そして (数値):バーコード位置のY座標
- 幅 (数値):バーコードの幅
- 身長 (数値):バーコードの高さ
例 (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
data.barcodes.forEach(barcode => {
console.log(`Found ${barcode.type}: ${barcode.text} on page ${barcode.page}`);
});
非同期処理
いつ IsAsync: true 設定されている、 API リクエストを非同期的に処理します。
ステータスコード: 202 Accepted
レスポンスヘッダー:
Location: https://api.pdf4me.com/api/v2/ReadBarcodes/poll/12345-abcde-67890
投票プロセス:
- 抽出する
Location202レスポンスのヘッダー - 投票する URL 使用 GET リクエスト
- 受信するまで投票を続けてください 200 OK 状態
- 最終回答には同じ内容が含まれています JSON バーコードデータを含むフォーマット
投票例:
// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');
// Poll until complete
while (true) {
const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
if (pollResponse.status === 200) {
const data = await pollResponse.json();
// Process data.barcodes array
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
エラー応答
の API 標準を返します HTTP エラーコードとエラー詳細:
- 無効なリクエストパラメータ
- 必須項目が欠落しています(
ドキュメントコンテンツ、ドキュメント名、バーコードタイプ、ページ、非同期) - 無効 Base64 エンコーディング
ドキュメントコンテンツ - 無効なバーコードタイプの配列形式
- 無効なページ指定
- 無効または欠落 API 鍵
- API キーが正しくありません Base64 エンコードされた Authorization ヘッダー
- ない
Authorization: 基本ヘッダー
- サーバー側処理エラー
- PDF 処理エラー
- バーコード認識エラー
エラー応答フォーマット:
{
"error": "Error message describing what went wrong"
}
回答形式の詳細
重要: の API 常に返される JSON 構造化されたバーコードデータを使用。
応答構造:
{
"barcodes": [
{
"type": "string", // Barcode type
"text": "string", // Extracted barcode content
"page": number, // Page number (1-based)
"x": number, // X coordinate
"y": number, // Y coordinate
"width": number, // Barcode width
"height": number // Barcode height
}
]
}
Content-Type ヘッダー:
- 成功:
application/json
検索結果なし: バーコードが見つからない場合、レスポンスには空の配列が含まれます。
{
"barcodes": []
}
複数のバーコード:
の API 同じページ上または異なるページ上の複数のバーコードを検出できます。検出されたすべてのバーコードは、 barcodes 配列。
リクエスト例
ヘッダ
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
注記:
- 手に入れよう API 鍵から PDF4me ダッシュボード
- の API キーは Base64 エンコードされ、「Basic」がプレフィックスとして付加されています。 Authorization ヘッダー
- 例: API 重要なのは
abc123エンコードして Base64 そして使用するAuthorization: Basic YWJjMTIz
ペイロード
例:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "document.pdf",
"barcodeType": ["all"],
"pages": "all",
"IsAsync": true
}
コードサンプル
の PDF4me バーコードを読み取る PDF REST API 複数のプログラミング言語のコードサンプルを提供します。開発環境に最適な言語を選択してください。
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
業界におけるユースケースとアプリケーション
- Finance & Banking
- Business & Enterprise
- E-commerce & Retail
- Government & Compliance
- Technology & Development
金融・銀行業務におけるユースケース
- 請求書処理請求書からバーコードデータを抽出し、自動支払い処理に利用する。
- 財務書類支払い処理のためにバーコード付きの財務書類を処理する
- 支払い処理: 金融書類のバーコードから支払い情報を抽出する
- 銀行との連携銀行アプリケーションおよびシステムにバーコード読み取り機能を統合する
ビジネスおよび企業向けユースケース
- 在庫管理: 製品のバーコードを読み取る PDF 在庫追跡のための書類
- サプライチェーンマネジメント: バーコードデータ抽出による製品の追跡 PDF 文書
- データ統合: バーコードデータを統合する PDFs ビジネスシステムへ
- 文書自動化スキャンした文書からバーコードデータを自動的に抽出する
- ワークフロー自動化文書管理システムにおけるバーコードデータ抽出の自動化
- ビジネスプロセス自動化企業業務におけるバーコード処理ワークフローを自動化する
Eコマースおよび小売業における活用事例
- 製品追跡: 製品のバーコードを読み取る PDF 在庫管理のための文書
- 注文処理注文書からバーコードデータを抽出して処理する。
- 品質管理:バーコードデータを使用して製品情報を確認します PDF 報道
- サプライチェーンマネジメント: バーコードデータ抽出による製品の追跡 PDF 文書
政府およびコンプライアンス関連のユースケース
- コンプライアンス監視コンプライアンス文書から追跡コードを抽出します。
- 規制関連文書バーコード付きの規制文書を処理する
- 政府文書政府文書からバーコードデータを抽出する
- 公文書: バーコード情報を含む公的記録を処理する
テクノロジーと開発のユースケース
- API 統合既存の文書処理ワークフローにバーコード読み取り機能を統合する
- バッチ処理: 大量の PDF バーコード抽出用の文書
- データ検証: 抽出したバーコードデータを検証します PDF 文書
- フォーム処理: バーコード情報を抽出します PDF フォームと申請書
- システム統合企業システムおよびワークフローにバーコード読み取り機能を統合する
バーコード認識機能
検出能力
- マルチフォーマット対応: さまざまな形式の1次元および2次元バーコードの認識
- 位置追跡: 座標を含む正確なバーコード位置および位置決めデータ
- ページ選択ページオプションを使用して、特定のページまたはドキュメント全体を処理します。
処理機能
- バッチ認識単一または複数のページから複数のバーコードを抽出します。
- 型フィルタリング: 検出するバーコードの種類を指定します。
barcodeType配列 - 構造化出力バーコードの種類、テキスト、ページ、位置情報を含むバーコードデータを返します。