ForHosting KIT · PDF・文書ツール

PDFファイルを指定順にオンラインで結合

PDFファイル結合は、2件以上のPDF参照を指定どおりの順序で1つのダウンロード可能な文書にまとめます。完成したファイルの総ページ数も返すため、自動処理の中で結果をご確認いただけます。処理は決定的で、ネットワークや外部モデルを使用せず、不完全なリクエストは実行前に拒否します。別々に作成された書類を、確実な納品物、保管資料、提出書類、またはお客様向けの1つのダウンロードにする場合にご利用ください。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

各ファイルを必要な順序に並べてください

最終文書に含めるPDF参照を最初にそろえてください。位置には意味があり、1番目のファイルの全ページ、2番目のファイルの全ページという順で最後まで追加されます。表紙、契約書、付属資料、署名票など、順序が重要な書類一式に適しています。本機能はファイル名、メタデータ、内容から並び順を推測しないため、実行前に一覧をご確認ください。2ファイル以上が必要であり、各参照には読み取り可能なPDFデータが必要です。システムで一覧を作る場合は、フォルダーの表示順、アップロード時刻、偶然のキー順に頼らず、業務規則が分かる時点で順序を明示してください。

ページと出力の処理方法をご確認ください

各入力のページオブジェクトを読み取り、寸法と内容を保持したうえで、新しいページツリーと相互参照表を持つPDFを書き出します。変換サービス、乱数、現在日時は使わないため、同じ入力を同じ順序で渡すと同じ結果になります。応答には結合済みPDF、入力ファイル数、実際に採用された総ページ数が含まれます。ベータ版では外部ページリソースを必要としない自己完結型ページを対象とし、安全に保持できない構造は拒否します。対応できない要素を無視せず、フォントや画像が欠けた、一見正常な文書を返さないための仕様です。エラーになった場合は、PDFの生成方法をご確認いただくか、事前に標準化してください。

完成文書を検証して自動化できます

成功後は、total_page_countを処理で想定した値と比較してください。2ページの契約書、4ページの別紙、1ページの署名票なら、結果は7ページです。この確認により、保管、送信、署名依頼の前に入力漏れを検出できます。file_countも、予定された構成数を把握しているシステムの確認項目になります。純粋で決定的な処理なので、再試行しても順序や結果は変わりません。APIによる自動処理は1リクエスト$0.002です。受領確認までは元ファイルを保管し、完成ファイルには分かりやすい名前を付けてください。監査記録にはPDF本文全体ではなく、並べた参照識別子を残すことを推奨します。

活用例

契約書一式を作成する

契約書、別紙、署名票を承認済みの順序でまとめ、完成後に総ページ数をご確認いただけます。

お客様向けダウンロードを1つにする

案内状、請求書、補足資料をまとめ、複数の添付ではなく整理された1つのPDFを提供できます。

保管用の提出物を準備する

個別に生成された報告書を1件の保管資料に結合し、ファイル数とページ数を記録できます。

よくある質問

PDFファイルは何件必要ですか？

PDF参照が2件以上必要です。空の一覧、1件だけの一覧、または一覧以外の値は入力エラーになります。

入力一覧の順序は重要ですか？

はい。先頭から順に処理し、各ファイルの全ページを次のファイルのページより前に配置します。

総ページ数はどのように計算しますか？

各入力から読み取って採用したページを数え、その合計をtotal_page_countとして返します。

自動結合の料金はいくらですか？

APIリクエスト1回につき$0.002です。この機能にはページ単位の追加料金はありません。

未対応のPDF構造は無視されますか？

いいえ。ベータ版パーサーは安全に保持できない構造を拒否し、不完全な出力を防ぎます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/pdf/merge-files

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/pdf/merge-files \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"files":["https://ejemplo.com/archivo.bin","https://ejemplo.com/archivo-2.bin"]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/merge-files", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "files": [
      "https://ejemplo.com/archivo.bin",
      "https://ejemplo.com/archivo-2.bin"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/merge-files",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "files": [
        "https://ejemplo.com/archivo.bin",
        "https://ejemplo.com/archivo-2.bin"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/merge-files", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"files":["https://ejemplo.com/archivo.bin","https://ejemplo.com/archivo-2.bin"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"files":["https://ejemplo.com/archivo.bin","https://ejemplo.com/archivo-2.bin"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/merge-files", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "files": [
    "https://ejemplo.com/archivo.bin",
    "https://ejemplo.com/archivo-2.bin"
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.merge_files",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_mb`	25
`max_pages`	200

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →