API 문서

모든 경로는 /api/v1 아래에 있으며 요청·응답 본문은 JSON 입니다. 성공 응답은 data(목록이면 meta 포함)로, 실패 응답은 error 로 감싸서 돌려줍니다.

// 성공 (목록)
{ "data": [ ... ], "meta": { "page": 1, "limit": 20, "total": 42, "totalPages": 3 } }

// 실패
{ "error": { "code": "VALIDATION_ERROR", "message": "이메일 형식이 올바르지 않습니다." } }

로그인으로 발급받은 access token 을 Authorization 헤더에 담아 보냅니다. access token 이 만료되면(401) refresh token 으로 재발급받습니다.

// 요청
{ "email": "you@agency.com", "password": "********" }

// 응답
{ "data": { "accessToken": "eyJ...", "refreshToken": "...", "expiresIn": 900, "user": { ... } } }

// 이후 요청 헤더
Authorization: Bearer <accessToken>

{
  "data": [
    {
      "id": "66f0c2a1b3e4d5f6a7b8c9d0",
      "title": "제주도 힐링 코스",
      "startDate": "2025-10-15",
      "endDate": "2025-10-18",
      "pickupLocation": "제주공항",
      "placeCount": 9,
      "createdAt": "2025-09-20T02:10:00.000Z",
      "updatedAt": "2025-09-20T02:10:00.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "totalPages": 1 }
}

• POST/api/v1/auth/login이메일·비밀번호 로그인 (토큰 발급)
• POST/api/v1/auth/refreshrefresh token 으로 토큰 재발급
• GET/api/v1/users/me내 프로필 조회
• GET/api/v1/courses코스 목록 (page, limit, q)
• POST/api/v1/courses코스 생성 (선택적으로 투어 동시 생성)
• GET/api/v1/courses/:id코스 상세
• GET/api/v1/tours투어 목록 (상태·유형 필터)
• GET/api/v1/tours/:tourId/reviews투어별 리뷰 목록
• GET/api/v1/schedule/events일정(캘린더) 이벤트 목록
• GET/api/v1/dashboard/overview관광 데이터 대시보드 요약