余白を追加 PDF - レイアウトフォーマッター API

PDF4me 余白を追加 PDF 任意の辺にカスタムマージンを追加できます PDF この文書。 API サービスプロセス PDF ファイルと余白をミリメートル単位で追加し、余白に合わせてページサイズを調整します。 API 受け取る PDF コンテンツを通じて REST API 通話を利用して Base64 安全なデータ送信のためのエンコード機能。このソリューションは、文書の書式設定、印刷準備、およびプロフェッショナルな文書における一貫したページレイアウトの確保に最適です。

関連ブログ記事

この機能に関するブログ記事はまだありません。近日公開予定です。

その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。

ブログをご覧ください →

認証 API リクエスト

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

Get your api Key

主な機能

• 個別マージン管理上下左右の余白をそれぞれ個別に設定する
• ミリメートル精度余白はすべてミリメートル単位（0～100の範囲）で指定されます。
• ページサイズ調整ページサイズは、追加された余白に合わせて自動的に調整されます。
• 文書保存レイアウトを調整しながら、元のコンテンツを維持します。
• 非同期処理: 長時間実行される操作のためのポーリングによる非同期処理のサポート

REST API 終点

の PDF4me REST API 標準を使用する HTTP リソースとやり取りするためのメソッド。すべてのマージン加算操作は、単一のエンドポイントを介して実行されます。

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

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.	output.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.
marginLeft	Optional	Left margin to add, in millimetres. Negative values count as 0. Type: integer.	20
marginRight	Optional	Right margin to add, in millimetres. Negative values count as 0. Type: integer.	20
marginTop	Optional	Top margin to add, in millimetres. Negative values count as 0. Type: integer.	25
marginBottom	Optional	Bottom margin to add, in millimetres. Negative values count as 0. Type: integer.	25

出力

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

Success Response

同期処理（デフォルト）

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

ステータスコード: 200 OK

Content-Type: application/json

応答本文：

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

回答欄:

• ドキュメント名 （文字列）：出力 PDF ファイル名
• ドキュメントコンテンツ (文字列): 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

Asynchronous Processing

非同期処理

いつ async: true 設定されている、 API リクエストを非同期的に処理します。

ステータスコード: 202 Accepted

レスポンスヘッダー:

Location: https://api.pdf4me.com/api/v2/AddMargin/poll/12345-abcde-67890

投票プロセス：

1. 抽出する Location 202レスポンスのヘッダー
2. 投票する URL 使用 GET リクエスト
3. 受信するまで投票を続けてください 200 OK 状態
4. 最終回答には同じ内容が含まれています JSON フォーマット docName そして docContent （Base64）

投票例：

// 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.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Error Responses

エラー応答

の API 標準を返します HTTP エラーコードとエラー詳細：

400 Bad Request

• 無効なリクエストパラメータ
• 必須項目が欠落しています（ドキュメントコンテンツ、 ドキュメント名）
• 無効 Base64 エンコーディング ドキュメントコンテンツ
• 無効なマージン値です（0～100の整数である必要があります）

401 Unauthorized

• 無効または欠落 API 鍵
• API キーが正しくありません Base64 エンコードされた Authorization ヘッダー
• ない 認証: 基本 ヘッダー

500 Internal Server Error

• サーバー側処理エラー
• PDF 処理エラー
• マージン追加失敗

エラー応答フォーマット:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

回答形式の詳細

重要： の API 常に返される JSON決してバイナリではない PDF データを直接取得します。

応答構造：

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type ヘッダー:

• 成功： application/json
• の PDF として埋め込まれています Base64 文字列内の JSON 応答

なぜ Base64？

• JSON-バイナリデータの安全なエンコード
• 簡単に伝達できます HTTP
• すべてのプログラミング言語に対応
• 直接埋め込むことができます JSON 問題から逃れることなく

デコード Base64 に PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", 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=="
}

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "marginLeft": 20,
  "marginRight": 20,
  "marginTop": 25,
  "marginBottom": 25,
  "async": true
}

コードサンプル

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

C#

C# （CSharpサンプル

完了 C# 余白を追加するための実装 PDF:

View C# Sample

Java

Java サンプル

Java 完全なエラー処理と応答処理を備えた実装：

View Java Sample

JavaScript

JavaScript サンプル

Node.js ブラウザ互換 JavaScript 実装：

View JavaScript Sample

Python

Python サンプル

Python requestsライブラリを使用した実装と JSON 処理:

View Python Sample

Salesforce

Salesforce サンプル

Salesforce 実装 Apex そして HTTP コールアウト:

View Salesforce Sample

n8n

n8n サンプル

n8n ワークフローの実装 HTTP リクエストノード:

View n8n Sample

Google Script

Google Script サンプル

Google Apps Script UrlFetchAppを使用した実装：

View Google Script Sample

AWS Lambda

AWS Lambda サンプル

AWS Lambda 実装 Node.js そして API ゲートウェイ:

View AWS Lambda Sample

PDF マージン機能

マージンコントロール

• 個人管理文書の各辺（上、下、左、右）に異なる余白を設定します。
• ミリメートル精度余白はすべてミリメートル単位で指定され、範囲は0～100です。
• ページサイズ調整ページサイズは、追加された余白に合わせて自動的に調整されます。
• レイアウトの維持余白を調整しながら文書構造を維持する

文書の強化

• 印刷最適化: さまざまな用紙サイズで文書が正しく印刷されることを確認してください。
• プロフェッショナルなフォーマットチーム間で一貫性のあるドキュメントレイアウトを作成する
• コンテンツの保存： オリジナル PDF 余白を追加しながらコンテンツは維持されます

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

Legal & Professional Services

法律・専門サービスにおけるユースケース

• 法的文書法的文書の書式基準への準拠を確保する
• 契約書の書式設定契約書や合意書を適切な余白でフォーマットする
• 裁判所文書: 標準的な余白要件を満たす裁判書類を作成する
• コンプライアンス文書規制基準を満たすようにコンプライアンス文書をフォーマットする

Education & Research

教育・研究における活用事例

• 学術論文研究論文や学位論文を出版要件を満たすようにフォーマットする
• 研究資料研究論文を出版に適した余白でフォーマットする
• 論文の書式設定論文や学位論文を学術基準に適合するようにフォーマットする
• 教育資料教育文書の余白を一定に保つ

Business & Enterprise

ビジネスおよび企業向けユースケース

• 文書の書式設定企業文書全体の余白を標準化する
• ビジネスレポート: 一貫性のあるレイアウトでプロフェッショナルなレポートを作成する
• プレゼンテーション資料プレゼンテーション資料の視覚的な魅力を高める
• 企業文書: 企業文書を標準余白でフォーマットする

Publishing & Printing

出版・印刷におけるユースケース

• 印刷準備特定の印刷要件に合わせてPDFを最適化する
• 書籍のフォーマット書籍や出版物を適切な余白でフォーマットする
• 雑誌のレイアウト標準余白で雑誌のレイアウトを作成する
• 印刷物印刷制作要件に合わせてドキュメントを最適化する

ヘルプが必要な場合

Get Your API KeyAPI SamplesGetting Started