Wordからページを削除する - ページ管理 API
PDF4me Wordからページを削除する 柔軟なページ選択オプションを使用して、Word 文書から特定のページまたはページ範囲を削除できます。 API このサービスは、Word ファイルを処理し、範囲指定削除 (開始ページから終了ページまで)、特定ページ番号削除 (カンマ区切りリスト)、および複合削除パターンを使用してページを削除します。 API Word文書コンテンツは以下を通じて受信されます REST API 通話を利用して Base64 安全な送信のためのエンコード機能。ページ選択、ドキュメント最適化、コンテンツクリーンアップを完全に制御できるこのソリューションは、ドキュメントの洗練、コンテンツ管理、ドキュメント準備のワークフローに最適です。
認証 API リクエスト
アクセスするには PDF4me REST APIすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、あなたが正規のユーザーであることが検証されます。 REST API。
主な機能
- 柔軟なページ選択範囲指定、特定の番号指定、またはその両方の組み合わせでページを削除します。
- 範囲ベースの削除: 開始ページから終了ページまで連続するページを削除します。
- 特定ページの削除カンマ区切りのページ番号を使用して個々のページを削除します。
- 文書最適化不要なコンテンツを削除してドキュメントを整理します
- フォーマットの保持: 元の文書の書式と構造を維持する
- メタデータの保存: ドキュメントのプロパティとカスタムメタデータを保持する
- 検証ページ番号の自動検証とエラー処理
- 文化支援: 地域固有の文書処理
REST API 終点
の PDF4me REST API 標準を使用する HTTP リソースとやり取りするためのメソッド。すべてのページ削除操作は、単一のエンドポイントを介して実行されます。
- 方法: POST
- 終点:
office/ApiV2Word/DeletePages
REST API パラメータ
Wordからページを削除する際のパラメータの完全なリスト REST APIパラメータは、理解と実装を容易にするためにカテゴリ別に整理されています。
重要: アスタリスク(*)が付いているパラメータは必須です。ページ削除パラメータ(startPage、endPage、またはpageNumbers)のうち、少なくとも1つを指定する必要があります。
| パラメータ | 必須 | その機能 | 例 |
|---|---|---|---|
| document | Required | Source file. `Name` must end in `.docx` or `.doc`. | { "Name": "document.docx" } |
| document.Name | Required | File name including its extension. Type: string. | { "Name": "document.docx" } |
| docContent | Required | The source file, base64-encoded. Type: string. | UEsDBBQABgAIAAAA... |
| isAsync | Optional | Process the request in the background. The call returns `202 Accepted`; poll the `Location` URL (`GetActionStatus`) for the result. Type: boolean. | |
| startPage | Optional | First page of a range to delete. Type: integer. | 2 |
| endPage | Optional | Last page of the range; defaults to the last page. Only used with `startPage`. Type: integer. | 5 |
| pageNumbers | Optional | Single pages to delete, comma-separated, e.g. `"8,10"`. Ranges are not supported; use `startPage`/`endPage`. Type: string. | "2,4,6" |
ページ削除モード
の API 複数のページ削除モードをサポートしています。
- 範囲削除: 使用
startPageそしてendPage連続するページを削除する - 特定ページの削除: 使用
pageNumbers個々のページを削除する - 複合欠失範囲指定と特定ページ指定の両方のパラメータを併用する
- 削除して終了: 使用のみ
startPageそのページから削除してドキュメントの終わりまで
注記: すべてのページ番号は1から始まります(最初のページは1であり、0ではありません)。ページ番号は、文書のページ数と自動的に照合されます。
出力
の PDF4me Wordからページを削除する REST API 処理モードに基づいて異なる応答を返します。 API Word文書をとして返します Base64-エンコードされた文字列 JSON フォーマットバイナリデータとしてではなく。
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
同期処理(デフォルト)
の API リクエストを処理し、以下を返します。
ステータスコード: 200 OK
コンテンツタイプ: application/json
応答本文:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
回答欄:
- 書類 (文字列):指定されたページが削除されたWord文書をエンコードしたもの Base64 弦
- ファイル名 (文字列):出力Wordファイル名
- 成功 (ブール値):リクエストが成功したかどうかを示します。
- エラーメッセージ (文字列またはnull):成功がfalseの場合のエラーの詳細
使用方法:
- 抽出する
documentからのフィールド JSON 応答 (Base64) - 解読する Base64 バイナリ形式のWord文書データを取得する文字列
- 必要に応じてWordファイルを保存または処理する。
例(JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
非同期処理
非同期動作 (202 Accepted ポーリングによる)は、リクエストボディパラメータではなく、サーバー構成によって制御されます。有効にすると、 API ポーリングで202ステータスを返す場合があります URL で Location ヘッダー。 URL と GET 200件のリクエストを受け取るまで OK 同じレスポンス形式(ドキュメント、ファイル名、成功、エラーメッセージ)を使用します。
エラー応答
の API 標準を返します HTTP エラーコードとエラー詳細:
- 無効なリクエストパラメータ
- 必須項目が欠落しています(
書類と名前、ドキュメントコンテンツ) - 少なくとも1つのページ削除基準が必要(
スタートページ、終了ページ、 またはページ番号) - 無効 Base64 エンコーディング
ドキュメントコンテンツ - 無効または破損したWord文書
スタートページを超えることはできない終了ページ- 無効なページ番号(文書の範囲外)
- 無効または欠落 API 鍵
- API キーが正しくありません Base64 エンコードされた Authorization ヘッダー
- ない
認証: 基本ヘッダー
- サーバー側処理エラー
- ワード文書の処理エラー
- ページ削除失敗
エラー応答フォーマット:
{
"error": "Error message describing what went wrong"
}
回答形式の詳細
重要: の API 常に返される JSONバイナリ形式のワードデータを直接扱わないでください。
応答構造:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
コンテンツタイプヘッダー:
- 成功:
application/json - Word文書は、 Base64 文字列内の JSON 応答
なぜ Base64?
- JSON-バイナリデータの安全なエンコード
- 簡単に伝達できます HTTP
- すべてのプログラミング言語に対応
- 直接埋め込むことができます JSON 問題から逃れることなく
デコード Base64 Word文書へ変換:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
ページ削除の例
さまざまなページ削除パターンを理解する:
| ドキュメントページ | スタートページ | 終了ページ | ページ番号 | 結果 |
|---|---|---|---|---|
| 1,2,3,4,5 | 2 | 4 | - | キープ数:1.5 |
| 1,2,3,4,5 | 3 | - | - | キープ数:1,2 |
| 1,2,3,4,5 | - | - | 「2,4」 | キープ数:1,3,5 |
| 1,2,3,4,5 | 2 | 3 | 「5」 | キープ数:1,4 |
リクエスト例
ヘッダ
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
注記:
- 手に入れよう API 鍵から PDF4me ダッシュボード
- の API キーは Base64 エンコードされ、「Basic」がプレフィックスとして付加されています。 Authorization ヘッダー
- 例: API 重要なのは
abc123エンコードして Base64 そして使用するAuthorization: Basic YWJjMTIz
ペイロード
基本的な例(範囲削除):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
具体的なページ例:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
高度な例(結合削除):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
コードサンプル
の PDF4me Wordからページを削除する REST API 複数のプログラミング言語のコードサンプルを提供します。開発環境に最適な言語を選択してください。
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
業界におけるユースケースとアプリケーション
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
法律・専門サービスにおけるユースケース
- 契約清掃契約書の写しから署名ページと付録を削除する
- 法的文書の作成クライアントへの配布前に機密ページを削除してください。
- 裁判所提出書類の最適化:ファイリング要件を満たすために不要なページを削除してください。
- クライアント向けドキュメントのバージョン: 内部のメモを削除してクリーンなバージョンを作成します
ビジネスおよび企業向けユースケース
- 提案の最適化: 顧客提案書から内部コストのページを削除する
- マーケティング資料のクリーンアップ: 現在の資料から古いコンテンツページを削除する
- プレゼンテーションの準備最終プレゼンテーションからバックアップスライドとメモを削除する
- 顧客向け成果物の最適化内部参照を削除してクリーンなバージョンを作成する
教育・研究における活用事例
- 医療報告書の整理: 機密性の高い患者情報ページを削除する
- 研究文書の最適化最終報告書から予備データを削除する
- プロトコル文書の作成公開されたプロトコルから内部審査ページを削除する
- コンプライアンス文書規制当局への提出書類を整理する
金融・銀行業務におけるユースケース
- 財務報告書の整理要約から詳細な付録を削除する
- 予算文書の最適化現在の予算から過去のデータページを削除します。
- 監査報告書の作成: 外部配布前に機密性の高い内部ページを削除してください。
- 規制関連書類の整理提出要件を満たすように文書を最適化する