コンテンツにスキップ

list-patient-image

患者に紐づく画像ファイルの一覧を取得する。ファイルが 1 件も無い、または保存先ディレクトリが未作成の場合は空の配列を返す。

リクエスト

項目 内容
メソッド GET
パス /api/list-patient-image
クエリ patient-id — 患者 ID(正の整数)

GET /api/list-patient-image?patient-id=1234

レスポンス

ファイル情報オブジェクトの配列。各要素は次のフィールドを持ち、createdAt の降順(新しい順)に並ぶ。

フィールド 内容
name ファイル名
createdAt ファイルの最終更新日時(YYYY-MM-DD HH:MM:SS)
size ファイルサイズ(バイト)

[
  {
    "name": "scan-002.jpg",
    "createdAt": "2026-07-10 14:32:05",
    "size": 204813
  },
  {
    "name": "scan-001.jpg",
    "createdAt": "2026-07-09 09:15:41",
    "size": 189220
  }
]

エラー

ステータス 意味
400 patient-id が指定されていない、または正の整数でない
503 一覧の取得に失敗した(保存先が未設定など)
500 その他の理由で取得に失敗した