メインコンテンツへスキップ

API リファレンス

認証

認証

MenuGaze は JWT ベースの認証を使用しています。認証が必要なすべてのエンドポイントでは、 Authorization ヘッダーに有効な Bearer トークンが必要です。トークンは、以下の認証エンドポイントからログインすることで取得できます。

POST /api/auth/signup

新しいアカウントを作成します。

認証: 公開 (トークン不要)

レート制限: IP あたり 15 分間に 10 リクエスト

リクエストボディ

{
  "name": "Jane Smith",
  "email": "jane@example.com",
  "password": "securepassword123",
  "restaurantName": "Jane's Bistro"
}

レスポンス (201 Created)

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

POST /api/auth/login

既存のアカウントでログインします。

認証: 公開 (トークン不要)

レート制限: IP あたり 15 分間に 10 リクエスト

リクエストボディ

{
  "email": "jane@example.com",
  "password": "securepassword123"
}

レスポンス (200 OK)

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "token": "eyJhbGciOiJIUzI1NiIs..."
  }
}

トークンの使用

認証が必要なすべてのリクエストで、Authorization ヘッダーにトークンを含めてください。

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

エラーレスポンス

  • 400 — リクエストボディのフィールドが不足しているか、無効です。
  • 401 — メールアドレスまたはパスワードが無効です。
  • 429 — レート制限を超えました。再試行できるまでの秒数は Retry-After ヘッダーで確認してください。