コンテンツにスキップ

create-multi-page-pdf-file

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

リクエスト

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

[
  [
    { "op": "moveTo", "x": 10, "y": 10 },
    { "op": "lineTo", "x": 100, "y": 10 },
    { "op": "createFont", "name": "mincho", "font": "MS Mincho", "size": 4 },
    { "op": "setFont", "name": "mincho" },
    { "op": "drawChars", "chars": "1ページ目", "xs": [10], "ys": [20] }
  ],
  [
    { "op": "drawChars", "chars": "2ページ目", "xs": [10], "ys": [20] }
  ]
]

レスポンス

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

true

エラー

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