← PDFtoSCAN ログイン / APIキーを取得

APIドキュメント

アプリケーションからPDFtoSCAN変換を使用します。すべてのAPIリクエストにはAPIキーが必要です（登録後に取得）。

ベースURL

すべてのエンドポイントは次の相対パスです：

https://pdftoscan.com/api/v1

認証

次のいずれかの方法を使用して、すべてのリクエストにAPIキーを含めます：

Header ヘッダー X-API-Key: your-api-key
Header ヘッダー Authorization: Bearer your-api-key

APIキーを取得するには：登録、次にダッシュボードで新しいキーを生成します。キーは一度だけ表示されます—安全に保管してください。

スキャン風に変換

POST /convert.php

PDFまたは画像をアップロードするか、ファイルURLを送信して、スキャン風のPDF（傾き、ノイズ、オプションの汚れた背景、オプションのA4）を受け取ります。

リクエスト

メソッド： POST
Content-Type： multipart/form-data (または application/x-www-form-urlencoded file_urlのみを使用する場合、application/x-www-form-urlencodedを使用できます)

パラメータ

パラメータ	タイプ	必須	説明
`file` または `pdf`	file	いいえ	変換するPDF、JPG、PNG、TIFF、またはWebPファイル（アップロード）。fileまたはfile_urlを使用します。
`file_url`	string	いいえ	変換するPDFまたは画像のHTTP(S) URL。ファイルアップロードまたはfile_url（最大50 MB、30秒タイムアウト）を使用します。
`color_mode`	string	いいえ	colorまたはbw。デフォルト：bw（白黒）。
`rotate`	number	いいえ	ページの傾き（度）（-1.5から1.5）。デフォルト：0。
`noise`	number	いいえ	ノイズ量0–1。デフォルト：0.1（10%）。
`dirty_background`	string	いいえ	1（デフォルト）で汚れた黒いエッジを表示、0で無効化。
`force_a4`	string	いいえ	1（デフォルト）でA4に出力を合わせる、0で元のサイズを保持。

レスポンス

成功（200）：レスポンスボディはPDFファイルです。バイナリコンテンツを保存またはストリーミングします。

エラー（4xx/5xx）：JSONボディ：{"ok": false, "error": "エラーメッセージ"}

ステータスコード

Code	意味
200	成功 — レスポンスはPDFです。
400	不正なリクエスト — ファイルがない、形式が間違っている、またはアップロードエラー。
401	未認証 — APIキーがないまたは無効。
405	メソッドが許可されていません — POSTを使用してください。
500	サーバーエラー — 変換に失敗しました。
503	サービス利用不可 — サーバーで変換が利用できません。

例

cURL

ファイルをアップロード：

curl -X POST "https://pdftoscan.com/api/v1/convert.php" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "color_mode=bw" \
  -F "force_a4=1" \
  -o scanned.pdf

またはファイルURLを送信：

curl -X POST "https://pdftoscan.com/api/v1/convert.php" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "file_url=https://example.com/document.pdf" \
  -d "color_mode=bw" \
  -d "force_a4=1" \
  -o scanned.pdf

JavaScript (fetch)

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('color_mode', 'bw');
formData.append('force_a4', '1');

const response = await fetch('https://pdftoscan.com/api/v1/convert.php', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: formData
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(err.error || 'Request failed');
}
const blob = await response.blob();
// e.g. save or open blob as PDF

Python

import requests

url = 'https://pdftoscan.com/api/v1/convert.php'
headers = {'X-API-Key': 'YOUR_API_KEY'}
files = {'file': open('document.pdf', 'rb')}
data = {'color_mode': 'bw', 'force_a4': '1'}

r = requests.post(url, headers=headers, files=files, data=data)

if r.status_code != 200:
    print(r.json().get('error', 'Error'))
else:
    with open('scanned.pdf', 'wb') as f:
        f.write(r.content)

CORS

ブラウザからのリクエストは任意のオリジンから許可されます。プリフライトOPTIONSリクエストがサポートされています。

使用量と制限

各変換はAPIキーごとにカウントされます。ダッシュボードで総使用量と過去7日間および30日間の使用量を確認できます。組み込みのレート制限はありません。サーバーのアップロードとリソースの制限が適用される場合があります。

対応形式

入力：PDF、JPG、JPEG、PNG、TIFF、WebP。

出力：常にPDF（スキャン風）。