ドキュメント

PDF の取得

GET/generations/{id}/pdf

こちらのサーバーで一度だけレンダリングされたドキュメントの PDF を、短時間有効なダウンロード URL として返します。まだ何も保存されていなければ、この呼び出しがオンデマンドでレンダリングし、完了後に応答します（通常は数秒）。別の場所ですでにレンダリング中なら 202 を返すので、少ししてからもう一度リクエストしてください。

パラメータ

名前	型	説明
`id`必須	uuid	ドキュメントの ID。
`download`	1	URL をドキュメント名の付いた添付ファイルにします。
`redirect`	1	JSON の代わりに URL への 302 を返します。

リクエスト

curl "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf?download=1" \
  -H "Authorization: Bearer pc_YOUR_TOKEN"

レスポンス

JSON

{
  "status": "ready",
  "url": "https://…/generation-pdfs/…/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b.pdf?token=…",
  "pages": 2,
  "expires_in": 60
}

URL は expires_in 秒後に無効になります。保存せず、あらためてリクエストしてください。
レンダリングに失敗した場合は 500 と pdf_render_failed を返します。もう一度リクエストすると再試行します。