find-available-shahokokuho¶

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

リクエスト¶

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

例¶

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

レスポンス¶

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

例¶

{
  "shahokokuhoId": 88,
  "patientId": 1234,
  "hokenshaBangou": 6123456,
  "hihokenshaKigou": "12",
  "hihokenshaBangou": "3456",
  "honninStore": 1,
  "validFrom": "2024-04-01",
  "validUpto": "0000-00-00",
  "koureiStore": 0,
  "edaban": "01"
}

エラー¶

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