create-pdf-file¶

1 ページ分の描画命令（drawer ops）を受け取り、1 ページの PDF ファイルを生成して、一時ファイル置き場（portal-tmp ディレクトリ）に指定した名前で保存します。生成した PDF は portal-tmp エンドポイントで取得できます。複数ページを作る場合は create-multi-page-pdf-file を使います。

リクエスト¶

項目	内容
メソッド	`POST`
パス	`/api/create-pdf-file`
クエリ	`paper-size` — 用紙サイズ（例 `A4`）、`file-name` — 保存する PDF ファイル名（`/` や `\` を含められない）
リクエストボディ	1 ページ分の描画命令（drawer ops）の配列。モデルページはなく、描画ライブラリ用の命令列

例¶

[
  { "op": "createFont", "name": "mincho", "font": "MS Mincho", "size": 4 },
  { "op": "setFont", "name": "mincho" },
  { "op": "drawChars", "chars": "処方箋", "xs": [10], "ys": [20] }
]

レスポンス¶

生成と保存に成功すると true を返します。ファイル本体はレスポンスに含まれず、portal-tmp エンドポイントで別途取得します。

例¶

true

エラー¶

ステータス	意味
`400`	`paper-size` または `file-name` が指定されていない、あるいはリクエストボディが配列でない
`503`	ファイル名が不正、または保存先ディレクトリ（`MYCLINIC_DATA_DIR`）が未設定など、ファイル操作に失敗した
`500`	PDF の生成に失敗した