PDF Blocks ドキュメント
各連携方法の出発点、アクションのカタログ、すべてのアクションに共通する概念、そしてセキュリティと法務のドキュメントをまとめています。
すべてのアクションは同じモデルに従います。ドキュメントを送信して何をするかを指定すると、処理済みのドキュメントがそのまま返ってきます。インストールが必要な SDK も、管理が必要な状態もなく、レスポンスを送信した後には何も保持されません。
呼び出したい方法から読み進めてください。ヘッダーの検索（⌘K、Windows では Ctrl K）から、すべてのページを検索することもできます。
連携方法を選ぶ
任意の言語でコードを書く方へ。
アクションごとに 1 回の認証済み HTTPS 呼び出しです。multipart/form-data を送ると PDF が返ります。すべてのアクションを利用でき、どの出力も次のアクションの有効な入力になります。
Power Automate でフローを作る方へ。
認定コネクタでは、17 のアクションすべてをフローのステップとして利用できます。ドキュメントはファイルコンテンツとしてステップ間を受け渡されるため、中間のストレージは必要ありません。
リクエストを試す
作業ディレクトリに input.pdf という名前の PDF を置き、ご自身のキーに置き換えて、次を実行してください。ドキュメントに透かしを付与し、結果を watermarked.pdf に書き出します。
curl https://api.pdfblocks.com/v1/add_text_watermark \
-H 'X-API-Key: your_api_key' \
-F file=@input.pdf \
-F line_1='CONFIDENTIAL' \
-o watermarked.pdfレスポンスは 200 OK、application/pdf で、処理済みのドキュメントが本文として返ります。単一出力のアクションはいずれも同じ形なので、アクション名を変えることが、次のアクションを導入する作業のほとんどを占めます。クイックスタートには、同じ呼び出しの Python、Node.js、PHP、Ruby などの例と、キーの取得方法を掲載しています。
できること
17 のアクションを、機能ごとにグループ化しています。各グループから完全なカタログに進むと、アクションごとのリファレンスページがあります。
順序を指定した複数のドキュメントを結合できます。1 つのドキュメントを、ページ数、指定したページ、ファイルサイズ、任意のグループ分けで分割することもできます。
テキストや画像をページに付与できます。位置、回転、不透明度、対象とするページを指定できます。
パスワードの追加と削除、権限制限の適用と解除、既存の署名の削除ができます。
ページの抽出、削除、回転、逆順、並べ替えができます。いずれも同じ範囲指定の構文を使います。
基本概念
いずれもすべてのアクションに共通する内容で、連携に関する疑問のほとんどはここで解決します。
- 認証：API キーの仕組み、リクエストごとに送信する内容、キーを安全に保つ方法を説明します。
- ファイルの操作：ドキュメントの送信方法、サイズの上限、返ってくる内容を説明します。
- ページの選択：ページを対象とするすべてのアクションが共通で使う
pagesの範囲指定構文です。 - アクションを連結する：ディスクに触れることなく、あるアクションの出力を次のアクションへ渡します。
- レスポンスフォーマット：コンテンツネゴシエーションと、複数のドキュメントを生成するアクションのレスポンスを説明します。
- エラー：エラーの本文と、各ステータスコードの意味を説明します。
- レート制限と使用量：何がリクエストとして数えられるか、上限に達したときに何が起きるかを説明します。
- リージョンとデータの保存地域：各リージョンのエンドポイントと、処理が行われる場所を説明します。
- バージョニングと安定性：稼働中の連携に影響し得る変更と、変更されないものを説明します。
セキュリティとコンプライアンス
審査でのご質問のほとんどは、次の 2 つの構造的な事実で決まります。ドキュメントは一切保存されません。そして、LLM がドキュメントを読み取ることはありません。各ファイルはメモリ上で処理され、同じレスポンスの中で返されます。
詳細は信頼のセクションに掲載しています。SOC 2 の統制マッピングを含むセキュリティ概要、HIPAA と BAA の条件、副処理者の一覧、そして法務文書（利用規約、プライバシーポリシー、データ処理契約）があります。