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

画像スタンプを追加する PDF - 透かし API

PDF4me 画像スタンプを追加する PDF カスタマイズ可能な画像スタンプと透かしを追加できます PDF 文書。 API サービスプロセス PDF ファイルに追加して、ドキュメントのブランディングとセキュリティのために、正確な位置、カスタムサイズ、フォーマットオプションで画像透かしを追加します。 API 受け取る PDF コンテンツと画像データ REST API 通話を利用して Base64 安全な送信のためのエンコード。柔軟な位置決め、カスタムサイズ設定、ページターゲティング、印刷制御をサポートするこのソリューションは、ドキュメントのブランディング、著作権保護、およびエンタープライズ用途に最適です。 PDF ワークフロー。

関連ブログ記事
この機能に関するブログ記事はまだありません。近日公開予定です。
その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。
ブログをご覧ください →

認証 API リクエスト​

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

Get your api Key

主な機能​

  • 画像透かしのサポート: 透かしやスタンプとしてカスタム画像を追加する PDF 文書
  • 柔軟な位置決め水平方向と垂直方向の配置をピクセル単位で正確に制御します。
  • カスタムサイズ画像サイズをミリメートルとピクセルの両方の測定値を使用して調整します。
  • 高度な書式設定: プロフェッショナルな外観にするために、不透明度、余白、背景オプションを設定します。
  • ページターゲティング特定のページまたは文書全体にスタンプを貼る
  • 印刷制御: 印刷時のみ、または画面上のみにスタンプを表示するように設定します。
  • プロフェッショナルな成果文書のセキュリティとブランディングを強化する画像透かしを作成する
  • シームレス API 統合: REST API 自動化向けに設計されています PDF 編集ワークフローとエンタープライズシステム統合

REST API 終点​

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

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

画像スタンプ機能​

画像フォーマットのサポート​

  • 一般的なフォーマット: サポート JPG、 PNGGIF、その他の標準画像フォーマット
  • Base64 エンコーディング: 安全な画像伝送 Base64 エンコーディング
  • サイズコントロールミリメートル単位（10～200mm）とピクセル単位（20～600px）の両方のサイズ指定オプションがあります。

配置とレイアウト​

  • 水平方向の配置左、中央、右のいずれかの位置オプション
  • 垂直方向の配置: 上部、中央、下部の配置制御
  • マージンコントロールミリメートル単位（0～100mm）とピクセル単位（0～300px）の両方の測定による高精度な位置決め
  • ページターゲティングページオプションを使用して特定のページに適用します（すべてのページの場合は空の文字列、「1」、「1,3,5」、「2-5」、「1,3,7-10」、「2-」）

高度な機能​

  • 不透明度コントロール: 透明度調整（0～100）：0＝透明、100＝完全に不透明
  • バックグラウンドモード: 画像を背面に配置するオプション (isBackground: true）または前（isBackground: falseコンテンツの
  • 印刷制御: 印刷時のみにスタンプが表示されるように設定する (showOnlyInPrint: true）または表示と印刷（showOnlyInPrint: false）
  • 非同期処理: 長時間実行される操作のためのポーリングによる非同期処理のサポート

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.
imageNameOptionalRequired. File name of the stamp image including its extension (e.g. `logo.png`); the extension sets the image type. Type: string.stamp.png
imageFileOptionalRequired. The stamp image. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference, or an `https` URL. Type: string.iVBORw0KGgoAAAANS...
alignXOptionalAn unrecognised value is rejected with 400. Type: string.Center
alignYOptionalAn unrecognised value is rejected with 400. Type: string.Middle
heightInMMOptionalImage height in millimetres. When `heightInMM` or `widthInMM` is set it overrides the `...InPx` size. If only one dimension is given the other keeps the image's aspect ratio; if none is given the image's own size is used. Type: string.30
widthInMMOptionalImage width in millimetres. When `heightInMM` or `widthInMM` is set it overrides the `...InPx` size. If only one dimension is given the other keeps the image's aspect ratio. Type: string.30
heightInPxOptionalImage height in points (1/72 inch), despite the name. Ignored when a millimetre size is given. Type: string.85
widthInPxOptionalImage width in points (1/72 inch), despite the name. Ignored when a millimetre size is given. Type: string.85
marginXInMMOptionalHorizontal distance in millimetres from the edge chosen by `alignX`. Overrides `marginXInPx` when either millimetre margin is set. Ignored when `alignX` is `center`. Type: string.10
marginYInMMOptionalVertical distance in millimetres from the edge chosen by `alignY`. Overrides `marginYInPx` when either millimetre margin is set. Ignored when `alignY` is `middle`. Type: string.10
marginXInPxOptionalHorizontal distance in points (1/72 inch, despite the name) from the edge chosen by `alignX`. Ignored when `alignX` is `center`. Type: string.28
marginYInPxOptionalVertical distance in points (1/72 inch, despite the name) from the edge chosen by `alignY`. Ignored when `alignY` is `middle`. Type: string.28
opacityOptionalOpacity from `0` (invisible) to `100` (fully opaque); values outside the range are clamped. Omitted or non-numeric counts as `0`, so always set it. Type: string.50
pagesOptionalPages to stamp, e.g. `1`, `1,3,5`, `2-5` or `2-` (2 to the last page). Type: string.""` or `"1-3"
showOnlyInPrintOptionalShow the stamp only when the PDF is printed, not on screen. Only used by ImageStamp; SignPdf ignores it. Type: boolean.false
isBackgroundOptionalPlace the stamp behind the page content instead of in front. Ignored when `showOnlyInPrint` is `true`. Only used by ImageStamp; SignPdf ignores it. Type: boolean.true

出力​

の 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=="
}

回答欄:

  • ドキュメント名 （文字列）：出力 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

リクエスト例​

ヘッダ​

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==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle",
  "pages": "",
  "heightInMM": "30",
  "widthInMM": "30",
  "heightInPx": "85",
  "widthInPx": "85",
  "marginXInMM": "10",
  "marginYInMM": "10",
  "marginXInPx": "28",
  "marginYInPx": "28",
  "opacity": 50,
  "isBackground": true,
  "showOnlyInPrint": false,
  "async": true
}

コードサンプル​

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

C# （CSharpサンプル

完了 C# 画像スタンプを追加するための実装 PDF:

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

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

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

ヘルプが必要な場合​

Get Your API KeyAPI SamplesGetting Started