주요 콘텐츠로 건너뛰기

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 헤더에서 확인하세요.