単一PDF非同期生成

POST /file/async/single エンドポイントは、指定されたデザインとパラメータから単一のPDFファイルを非同期的に生成します。即座に requestId とファイル情報を返すため、タイムアウトを避けることができます。

エンドポイント情報

• URL: https://api.re-port-flow.com/v1/file/async/single
• メソッド: POST
• 認証: appkey ヘッダーが必要
• タイムアウト: なし（非同期処理）
• リクエストサイズ上限: 50MB（Base64エンコード後、実質約37MB相当）

使用例

cURL

curl -X POST https://api.re-port-flow.com/v1/file/async/single \
  -H "appkey: your-application-key" \
  -H "Content-Type: application/json" \
  -d '{
    "designId": "550e8400-e29b-41d4-a716-446655440000",
    "version": 1,
    "content": {
      "fileName": "invoice.pdf",
      "shareType": "workspace",
      "passcodeEnabled": false,
      "params": {
        "customerName": "山田太郎",
        "invoiceNumber": "INV-2024-001",
        "amount": 10000
      }
    }
  }'

リクエストパラメータ

フィールド	型	必須	説明
designId	string (UUID)	✓	デザインID
version	integer	✓	バージョン番号
content.fileName	string	✓	ファイル名（/ \\ : * ? " < > | および制御文字以外は使用可能）
content.shareType	string	-	共有タイプ（workspace / invited / public、デフォルト: workspace）
content.passcodeEnabled	boolean	-	パスコード保護（デフォルト: false）
content.passthrough	object	-	レスポンスの files[].passthrough に透過する任意のメタデータ（例: { "pageId": "abc123" }）
content.params	object	✓	テンプレートに埋め込むパラメータ（デザインパラメータ取得APIで構造を確認可能）

レスポンス

成功時 (202 Accepted)

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://api.re-port-flow.com/v1/file/download/{requestId}",
  "files": [
    {
      "fileName": "invoice.pdf",
      "fileId": "7f3d1a2b-4c5e-6f7a-8b9c-0d1e2f3a4b5c",
      "passthrough": { "pageId": "abc123" },
      "share": {
        "shareType": "workspace",
        "url": "https://app.re-port-flow.com/file/{requestId}/{fileId}",
        "passcodeEnabled": false
      }
    }
  ]
}

フィールド	型	説明
requestId	string (UUID)	リクエストID（ダウンロードエンドポイントで使用）
url	string (URI)	ZIPダウンロードURL
files	array	生成されたファイルの情報
files[].fileName	string	ファイル名
files[].fileId	string	ファイルID（個別ダウンロードエンドポイントで使用）
files[].passthrough	object	リクエスト時に指定した content.passthrough の値（指定時のみ）
files[].share.shareType	string	共有タイプ（workspace / invited / public）
files[].share.url	string	ファイル表示URL
files[].share.passcodeEnabled	boolean	パスコード有効フラグ
files[].share.passcode	string	サーバー生成パスコード（passcodeEnabled=true かつ生成直後のみ）

エラー時

同期生成エンドポイントと同様のエラーレスポンスを返します。詳細は単一PDF同期生成を参照してください。

非同期処理のフロー

1. クライアント → API: 生成リクエスト送信
   ↓
2. API → クライアント: 即座に requestId・url・files を返す (202 Accepted)
   ↓
3. API: バックグラウンドでPDF生成開始
   ↓
4. API: PDF生成完了後、S3にアップロード
   ↓
5. クライアント: 返された url または /download/{requestId}/{fileId} からPDFをダウンロード

ユースケース

ケース1: バックグラウンドでPDF生成

ユーザーのリクエストを即座に受け付け、バックグラウンドで処理します。

app.post('/api/generate-report', async (req, res) => {
  const response = await axios.post(
    'https://api.re-port-flow.com/v1/file/async/single',
    { designId: '...', version: 1, content: { fileName: 'report.pdf', params: req.body } },
    { headers: { 'appkey': process.env.APP_KEY } }
  );

  const { requestId, url, files } = response.data;

  // 即座にレスポンス
  res.status(202).json({
    message: 'レポート生成を開始しました',
    requestId,
    downloadUrl: url,
    fileId: files[0].fileId
  });
});

ケース2: Webhook通知の活用（推奨）

ReportFlowの標準Webhook機能を使用すると、ポーリング不要でリアルタイムに完了通知を受け取れます。

詳細はWebhook通知ガイドを参照してください。

次のステップ

• 複数PDF非同期生成 - 複数のPDFを非同期で一括生成
• 非同期ワークフロー - 大量生成のベストプラクティス
• ファイルダウンロード - 生成されたファイルのダウンロード方法