API リファレンス

ベースURL: https://<API_BASE_URL>/api/v1

認証

メソッド	エンドポイント	説明	認証
POST	/auth/register	ユーザー登録	不要
POST	/auth/login	メール・パスワードログイン	不要
POST	/auth/liff/login	LINE LIFF ログイン	不要
POST	/auth/social/google	Google OAuth コールバック	不要
POST	/auth/social/apple	Apple OAuth コールバック	不要
GET	/auth/verify-email	メール確認	不要
POST	/auth/resend-verification	確認メール再送	不要
POST	/auth/forgot-password	パスワードリセットメール送信	不要
POST	/auth/reset-password	パスワードリセット完了	不要
POST	/auth/refresh	アクセストークン更新	不要
POST	/auth/change-password	パスワード変更	JWT
POST	/auth/send-phone-otp	SMS OTP 送信	JWT
POST	/auth/verify-phone	電話番号確認	JWT
GET	/auth/sessions	ログイン中のデバイス一覧	JWT
GET	/auth/sessions/{id}	セッション詳細	JWT
POST	/auth/sessions/logout-all	全デバイスからログアウト	JWT

ユーザープロフィール

メソッド	エンドポイント	説明	認証
GET	/users/me	自分のプロフィール取得	JWT
POST	/users/me/onboarding-role	ロール設定	JWT
POST	/users/email/send-code	メール変更確認コード送信	JWT
POST	/users/email/verify-code	メール変更確認	JWT
GET	/car-owner/profile	車オーナープロフィール取得	JWT

ナンバープレート

メソッド	エンドポイント	説明	認証
GET	/car-owner/plates	プレート一覧	JWT
POST	/car-owner/plates	プレート登録	JWT
GET	/car-owner/plates/{plateId}	プレート詳細	JWT
PUT	/car-owner/plates/{plateId}	プレート更新	JWT
DELETE	/car-owner/plates/{plateId}	プレート削除	JWT
POST	/car-owner/plates/detect	画像からプレート認識	JWT

駐車場（公開）

メソッド	エンドポイント	説明	認証
GET	/parking-lots	駐車場検索（位置情報）	不要
GET	/parking-lots/{lotId}	駐車場詳細	不要
GET	/parking-lots/{lotId}/availability	空き状況確認	不要

駐車セッション

メソッド	エンドポイント	説明	認証
GET	/sessions	セッション一覧	JWT
GET	/sessions/active	アクティブセッション	JWT
GET	/sessions/{sessionId}	セッション詳細	JWT

決済・カード管理

メソッド	エンドポイント	説明	認証
GET	/payment-methods	カード一覧	JWT
POST	/payment-methods	SetupIntent 作成	JWT
POST	/payment-methods/stripe-callback	カード登録確定	JWT
POST	/payment-methods/{id}/set-default	デフォルトカード設定	JWT
GET	/payments	支払い履歴	JWT
GET	/payments/{paymentId}	支払い詳細	JWT
POST	/payments/{sessionId}/create-payment-link	決済リンク作成	JWT
POST	/payments/{sessionId}/process-auto-payment	自動決済実行	JWT
POST	/payments/webhooks/stripe	Stripe Webhook	不要

クーポン

メソッド	エンドポイント	説明	認証
GET	/car-owner/coupons	クーポン一覧	JWT
POST	/car-owner/coupons/redeem	クーポン利用	JWT
POST	/car-owner/coupons/add-to-session/{sessionId}	セッションにクーポン適用	JWT

カーグループ（共同使用）

メソッド	エンドポイント	説明	認証
GET	/car-co-owner	グループ一覧	JWT
POST	/car-co-owner	グループ作成	JWT
POST	/car-co-owner/join/{code}	招待コードで参加	JWT
GET	/car-co-owner/detail/{groupId}	グループ詳細	JWT
DELETE	/car-co-owner/member/{groupId}/{memberId}	メンバー削除	JWT

オーナー向けAPI

メソッド	エンドポイント	説明	認証
GET	/parking-owner/parking-lots	自分の駐車場一覧	JWT（オーナー）
POST	/parking-owner/parking-lots	駐車場申請	JWT（オーナー）
PUT	/parking-owner/parking-lots/{lotId}	駐車場更新	JWT（オーナー）
GET	/parking-owner/sessions	セッション一覧	JWT（オーナー）
GET	/parking-owner/sessions/parking-status	リアルタイム稼働状況	JWT（オーナー）
POST	/parking-owner/dashboard	ダッシュボード指標	JWT（オーナー）
GET	/parking-owner/analytics/hourly-revenue	時間帯別収益	JWT（オーナー）
GET	/parking-owner/analytics/occupancy	稼働率	JWT（オーナー）
GET	/parking-owner/deposits	入金履歴	JWT（オーナー）
POST	/parking-owner/connect	Stripe Connect 作成	JWT（オーナー）

ハードウェア（SmoothBox）

メソッド	エンドポイント	説明	認証
POST	/hardware/detection	入出庫検知を送信	APIキー + HMAC
POST	/hardware/detect-plate	プレート直接認識	APIキー + HMAC