get-patient-hoken¶

指定した日付の時点で有効な、患者のすべての保険を取得する。会計や資格確認で、その日に使える保険を一覧するために使います。

リクエスト¶

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

例¶

GET /api/get-patient-hoken?patient-id=1234&at=2026-07-10

レスポンス¶

次の 6 要素の配列。

位置	内容
1	イベント ID（`number`。取得時点を表す）
2	Patient
3	Shahokokuho の配列（有効なもの）
4	Koukikourei の配列（有効なもの）
5	Roujin の配列（有効なもの）
6	Kouhi の配列（有効なもの）

例¶

[
  4521,
  {
    "patientId": 1234,
    "lastName": "山田",
    "firstName": "太郎",
    "lastNameYomi": "やまだ",
    "firstNameYomi": "たろう",
    "sex": "M",
    "birthday": "1980-05-15",
    "address": "東京都新宿区西新宿1-1-1",
    "phone": "03-1234-5678"
  },
  [
    {
      "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`	取得に失敗した