start-visit¶

患者の診察を開始する。指定した患者と日時で新しい診察を作成し、その時点で有効な保険を自動で割り当てる。新規行を作成する非冪等な操作のため POST で受け付け、作成後はレガシーサーバーへ変更が通知される。

リクエスト¶

項目	内容
メソッド	`POST`
パス	`/api/start-visit`
クエリ	`patient-id` — 患者 ID（正の整数）、`at` — 診察日時（YYYY-MM-DD HH:MM:SS）

例¶

POST /api/start-visit?patient-id=1234&at=2026-07-10 09:30:00

レスポンス¶

作成された Visit。有効な保険が自動で割り当てられる。

例¶

{
  "visitId": 5678,
  "patientId": 1234,
  "visitedAt": "2026-07-10 09:30:00",
  "shahokokuhoId": 100,
  "roujinId": 0,
  "kouhi1Id": 0,
  "kouhi2Id": 0,
  "kouhi3Id": 0,
  "koukikoureiId": 0
}

エラー¶

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