ゴルフ場API は用途の異なる2系統で構成されます。パートナー予約連携API（会員向け）とは別物です。

APIキー認証。すべてのリクエストに X-API-Key ヘッダーを付与します。キーは管理者が発行し、integration タイプのキーは 1キーにつき1ゴルフ場（owner_id）に紐づきます。リクエストの golf_club_id が紐づきと一致しない場合は 403（IDOR対策）。

POST /api/integration/tee-times/sync.php HTTP/1.1
Host: govigolf.comX-API-Key: YOUR_API_KEY
Content-Type: application/json

スコープ: 参照系は integration:read、更新系は integration:write。

ゴルフ場管理画面のログインセッション、または JWT Bearer トークンで認証します（GolfClubAuthService）。対象ゴルフ場は認証情報から特定されるため、golf_club_id をパラメータで渡す必要はありません。

GET /api/manage/reservations/list.php HTTP/1.1
Host: govigolf.comAuthorization: Bearer <JWT>

スコープ（リソース別）: reservations:read/write / tee_times:read/write / notifications:read/write / settings:read/write / reports:read。

CSVエクスポートを除き、すべて以下の JSON エンベロープで返ります。

{
  "status": "success",
  "message": "...",
  "data": { ... }
}

{
  "status": "error",
  "message": "エラー内容",
  "data": null
}

外部システムのティータイム枠を GOVIGO に同期（外部→GOVIGO）。

POST /api/integration/tee-times/sync.php HTTP/1.1
Host: govigolf.comX-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "golf_club_id": 1,
  "slots": [
    { "course_id": 10, "tee_time": "2026-07-01 07:30", "total_slots": 4, "available_slots": 4 }
  ]
}

GOVIGO 側のティータイムを取得（GOVIGO→外部）。

GET /api/integration/tee-times/pull.php?golf_club_id=1&date_from=2026-07-01&date_to=2026-07-07 HTTP/1.1
Host: govigolf.comX-API-Key: YOUR_API_KEY

在庫（枠数）を期間・コース単位で同期します。

POST /api/integration/inventory/sync.php HTTP/1.1
Host: govigolf.comX-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "golf_club_id": 1,
  "date_from": "2026-07-01",
  "date_to": "2026-07-01",
  "inventory": [
    { "course_id": 10, "date": "2026-07-01", "slots": [ { "time": "07:30", "total": 4, "available": 2 } ] }
  ]
}

在庫状況のサマリーを取得します。

GET /api/integration/inventory/status.php?golf_club_id=1&date_from=2026-07-01&date_to=2026-07-31 HTTP/1.1
Host: govigolf.comX-API-Key: YOUR_API_KEY

外部システムで発生した予約を GOVIGO に取り込みます（外部→GOVIGO）。ボディは予約作成と同形式で、external_ref が必須（冪等キー）。

GOVIGO 側の予約を外部システムへ連携するための取得（プッシュ確認）。

予約・在庫などのイベント通知先 URL を登録します。

POST /api/integration/webhooks/subscribe.php HTTP/1.1
Host: govigolf.comX-API-Key: YOUR_API_KEY
Content-Type: application/json

{ "golf_club_id": 1, "url": "https://example.com/hook", "events": ["reservation.created"] }

登録済み Webhook の一覧を取得します。

登録済み Webhook を解除します。

指定サブスクリプションにテストイベントを送信します。

自ゴルフ場の予約一覧を取得します。

GET /api/manage/reservations/list.php?date_from=2026-07-01&date_to=2026-07-31&page=1 HTTP/1.1
Host: govigolf.comAuthorization: Bearer <JWT>

予約の詳細を取得します。

予約ステータスを変更します（キャンセル処理を含む）。

POST /api/manage/reservations/update-status.php HTTP/1.1
Host: govigolf.comAuthorization: Bearer <JWT>
Content-Type: application/json

{ "reservation_id": 123, "status": 2, "memo": "確認済み" }

指定日の予約枠一覧を取得します。

予約枠を1件更新します。

複数の予約枠をまとめて更新します（最大 200 件）。

POST /api/manage/tee-times/bulk-update.php HTTP/1.1
Host: govigolf.comAuthorization: Bearer <JWT>
Content-Type: application/json

{ "slots": [ { "slot_id": 501, "available_slots": 0, "status": 1 }, { "slot_id": 502, "available_slots": 2 } ] }

通知一覧を取得します。

通知を既読にします。

未読通知数を取得します。パラメータなし。

ゴルフ場設定を取得します。

ゴルフ場設定を更新します。

POST /api/manage/settings/update.php HTTP/1.1
Host: govigolf.comAuthorization: Bearer <JWT>
Content-Type: application/json

{ "settings": { "auto_confirm": "1", "cancel_deadline_days": "3" } }

予約実績の集計を取得します。

予約データを CSV でエクスポートします。レスポンスは text/csv（JSONエンベロープではありません）。

GET /api/manage/reports/export.php?date_from=2026-07-01&date_to=2026-07-31 HTTP/1.1
Host: govigolf.comAuthorization: Bearer <JWT>