テキストスタンプを追加する PDF - テキスト透かし API

PDF4me テキストスタンプを追加する PDF カスタマイズ可能なテキスト透かしを追加できます PDF 認証および著作権侵害防止のための文書。 API サービスプロセス PDF ファイルを追加し、テキスト、位置、スタイル、回転、外観を制御できるテキストスタンプを追加します。 API 受け取る PDF コンテンツを通じて REST API 通話を利用して Base64 安全な送信のためのエンコード。このソリューションは、ドキュメントのブランディング、著作権保護、ステータスインジケーター、および企業向け用途に最適です。 PDF ワークフロー。

関連ブログ記事

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

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

ブログをご覧ください →

認証 API リクエスト

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

Get your api Key

主な機能

• 柔軟な位置決め水平方向と垂直方向の配置をピクセル単位で正確に制御します。
• カスタムスタイリングさまざまなフォント、サイズ、色、テキスト効果（太字、斜体、下線）から選択できます。
• 高度な書式設定: 透明度、回転、余白、背景オプションを設定します
• ページターゲティング特定のページまたは文書全体にスタンプを貼る
• 印刷制御: 印刷時のみ、または画面上のみにスタンプを表示するように設定します。
• プロフェッショナルな成果文書のセキュリティとブランディングを強化する透かしを作成する
• 非同期処理: 長時間実行される操作のためのポーリングによる非同期処理のサポート

REST API 終点

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

• 方法： 役職
• 終点： /api/v2/Stamp

サポートされているテキストスタンプ機能

の API さまざまなテキストスタンプおよび透かし機能に対する包括的なサポートを提供します。

テキストカスタマイズオプション

• フォントの選択Arial、Times New Roman、Helvetica、またはCourier New Romanから選択してください。
• サイズコントロールフォントサイズは8～72の間で調整可能
• カラーオプション: 16進数カラーコードによるフルカラースペクトル対応（例：赤は#FF0000）
• テキストエフェクト: 太字、斜体、下線などの書式設定オプション
• カスタムテキスト記号や特殊文字を含むあらゆるテキストコンテンツに対応

配置とレイアウト

• 水平方向の配置左、中央、右の配置オプション
• 垂直方向の配置: 上部、中央、下部の配置制御
• マージンコントロールミリメートル単位とピクセル単位の両方の測定による高精度な位置決め
• 回転サポートテキスト回転：0（水平）、45（斜め）、90（垂直）、-45（逆斜め）
• 柔軟な勤務形態: 正確な寸法で任意のページ位置をサポート

高度な機能

• 不透明度コントロール: 透かしの度合いを0～100に調整可能（目立たないようにしたり、はっきりとさせたりできます）
• バックグラウンドモードコンテンツの背後または前面にテキストを配置するオプション
• 印刷制御: 表示と印刷の両方にスタンプを表示するか、印刷のみにスタンプを表示するかを設定します。
• ページターゲティング特定のページまたはドキュメント全体に適用する
• テキストフィッティングページ境界に合わせてテキストサイズを自動調整する機能（オプション）

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.
pages	Optional	Pages to stamp, e.g. `all`, `1`, `1,3,5`, `2-5` or `2-` (2 to the last page). Type: string.	all
text	Optional	Text to stamp on the pages. Type: string.	CONFIDENTIAL - PDF4me Watermark
alignX	Optional	An unrecognised value is rejected with 400. Type: string.	center
alignY	Optional	An unrecognised value is rejected with 400. Type: string.	middle
marginXInMM	Optional	Horizontal distance in millimetres from the edge chosen by `alignX`. Overrides `marginXInPx` when either millimetre margin is set. Ignored when `alignX` is `center`. Type: string.	50
marginYInMM	Optional	Vertical distance in millimetres from the edge chosen by `alignY`. Overrides `marginYInPx` when either millimetre margin is set. Ignored when `alignY` is `middle`. Type: string.	50
marginXInPx	Optional	Horizontal distance in points (1/72 inch, despite the name) from the edge chosen by `alignX`. Ignored when `alignX` is `center`. Type: string.	150
marginYInPx	Optional	Vertical distance in points (1/72 inch, despite the name) from the edge chosen by `alignY`. Ignored when `alignY` is `middle`. Type: string.	150
opacity	Optional	Opacity from `0` (invisible) to `100` (fully opaque); values outside the range are clamped. Defaults to `100`. Type: string.	30
fontName	Optional	Font of the stamp text, e.g. `Arial` or `Times New Roman`. Defaults to `Arial`. Type: string.	Arial
fontSize	Optional	Font size in points. 0 or less uses `12`. Type: integer.	24
underline	Optional	Underline the stamp text. Type: boolean.	false
isBold	Optional	Make the stamp text bold. Type: boolean.	true
isItalics	Optional	Make the stamp text italic. Type: boolean.	false
fontColor	Optional	Text color as a hex value, e.g. `#FF0000`. An invalid value is rejected with 400. Type: string.	#FF0000
rotate	Optional	Rotation of the stamp in degrees, e.g. `45`. Type: integer.	45
showOnlyInPrint	Optional	Show the stamp only when the PDF is printed, not on screen. Type: boolean.	false
isBackground	Optional	Place the stamp behind the page content instead of in front. Ignored when `showOnlyInPrint` is `true`. Type: boolean.	true
transverse	Optional	Use transverse positioning for the stamp. Type: boolean.	false
fitTextOverPage	Optional	Scale the text to fit across the page instead of using `fontSize`. Type: boolean.	false

出力

の 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/Stamp/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

• 無効なリクエストパラメータ
• 必須項目が欠落しています（ドキュメントコンテンツ、 ドキュメント名、 ページ、 文章、 alignX、 整列Y）
• 無効 Base64 エンコーディング ドキュメントコンテンツ
• 無効な配置値です（alignX の場合は「left」、「center」、「right」、alignY の場合は「top」、「middle」、「bottom」のいずれかを指定する必要があります）。
• 無効なフォントサイズです（8～72ポイントの範囲である必要があります）
• 不透明度の値が無効です（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==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle",
  "marginXInMM": "50",
  "marginYInMM": "50",
  "marginXInPx": "150",
  "marginYInPx": "150",
  "opacity": "30",
  "fontName": "Arial",
  "fontSize": 24,
  "fontColor": "#FF0000",
  "isBold": true,
  "isItalics": false,
  "underline": false,
  "rotate": 45,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false,
  "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 実装 CRM 統合：

View Salesforce Sample

n8n

n8n サンプル

n8n 自動化のためのワークフロー実装：

View n8n Sample

Google Script

Google Script サンプル

Google Apps Script 実装 Google Workspace 統合：

View Google Script Sample

AWS Lambda

AWS Lambda サンプル

サーバーレス AWS Lambda 関数実装:

View AWS Lambda Sample

テキストスタンプ機能

カスタマイズオプション

• フォントコントロールサイズと色のカスタマイズが可能な複数のフォントファミリー
• テキストエフェクト: 太字、斜体、下線などの書式設定オプション
• カラーマネジメント: 16進数コードによるフルスペクトルカラーサポート
• テキストコンテンツ記号や特殊文字を含むあらゆるテキストに対応
• プロのスタイリング: 鮮明な視認性を備えた高品質なテキストレンダリング

配置とレイアウト

• アライメント制御: 正確な水平および垂直位置合わせオプション
• 余白設定ミリメートル単位とピクセル単位の両方の位置決め
• 回転サポート斜めまたは角度のついた透かしのテキスト回転
• 柔軟な勤務形態: あらゆるページ位置と向きに対応
• ページターゲティング特定のページまたはドキュメント全体に適用する

高度な機能

• 不透明度コントロール透かしの透明度を調整して、目立たないものから目立つものまで表示できます。
• バックグラウンドモードコンテンツの背後または前面にテキストを配置するオプション
• 印刷制御: 印刷時のみ、または画面上のみにスタンプを表示するように設定します。
• テキストの調整ページ境界に合わせてテキストサイズを自動的に調整します
• 横モードページ全体にスタンプを押します

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

Legal & Professional Services

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

• 法的文書法的文書に法的免責事項と機密保持通知を適用する
• 契約印紙契約書や合意書にステータススタンプを追加する
• 機密保持に関する通知機密性の高い法的文書には機密保持印を貼付する
• 適合性スタンプ: 法務文書に規制遵守に関する通知を追加する

Business & Enterprise

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

• ドキュメントブランディングPDF文書に会社のロゴ、透かし、ブランディング要素を追加する
• ステータス指標文書の状態を示すために、「下書き」、「機密」、「承認済み」のスタンプを追加してください。
• レポート生成生成されたドキュメントにタイムスタンプ、ページ番号、レポート識別子を追加する
• コーポレートブランディングビジネス文書全体に一貫したブランディングを適用する

Finance & Banking

金融・銀行業務におけるユースケース

• 財務報告書財務報告書や明細書にステータススタンプを追加する
• 請求書へのスタンプ押印請求書と発注書に承認印を押す
• コンプライアンス文書: 金融書類に規制関連の印鑑を追加する
• 監査証跡財務書類にタイムスタンプ付きの監査証跡を作成する

Government & Compliance

政府およびコンプライアンス関連のユースケース

• 著作権保護知的財産を保護するために、著作権表示と所有権印を貼付する。
• 規制遵守規制要件を満たすためにコンプライアンススタンプを追加する
• 公式文書政府文書に公式印鑑を押す
• 公文書公的記録や文書に分類スタンプを追加する

ヘルプが必要な場合

Get Your API KeyAPI SamplesGetting Started