コンテンツにスキップ

find-available-kouhi

指定した日付の時点で有効な公費のうち、代表となる 1 件を取得する。該当する公費が複数あるときは最後の 1 件を返し、なければ null を返します。

リクエスト

項目 内容
メソッド GET
パス /api/find-available-kouhi
クエリ patient-id — 患者 ID(正の整数)、at — 基準日 (YYYY-MM-DD)

GET /api/find-available-kouhi?patient-id=1234&at=2026-07-10

レスポンス

有効な Kouhi が 1 件、または該当がなければ null

{
  "kouhiId": 55,
  "futansha": 54136015,
  "jukyuusha": 1234567,
  "validFrom": "2024-04-01",
  "validUpto": "0000-00-00",
  "patientId": 1234,
  "memo": ""
}

エラー

ステータス 意味
400 patient-id または at が指定されていない、または不正
404 指定した ID の患者が存在しない
500 取得に失敗した