Travel REST API Reference

프론트엔드 및 서드파티 서비스 연동을 위한 Travel Main Server의 공식 API 명세서입니다.
모든 요청은 HTTPS를 통해 이루어지며, 응답은 JSON 포맷으로 반환됩니다.

Base URL https://yeohaenghage.com/api

로그인

POST /auth/login

이메일과 비밀번호를 사용하여 서비스에 로그인하고, Access Token과 Refresh Token을 발급받습니다.

Request Body

파라미터 타입 필수 설명
email String Yes 사용자 이메일 주소
password String Yes 비밀번호 (최소 8자 이상)
Example Request 
{

  "email": "user@travel.com",

  "password": "secure_password123"

}
Response (200 OK) 
{

  "success": true,

  "data": {

    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6...",

    "refresh_token": "def502005f1dfa82be1e...",

    "expires_in": 3600

  }

}

피드 목록 조회

GET /feeds

Redis 캐싱 및 랭킹 알고리즘이 적용된 피드 목록을 페이지네이션하여 조회합니다.

Query Parameters

파라미터 타입 필수 설명
cursor String No 다음 페이지 조회를 위한 커서 값. (첫 요청 시 생략)
limit Number No 조회할 피드 개수 (기본값: 20, 최대: 50)
Response (200 OK) 
{

  "success": true,

  "data": {

    "feeds": [

      {

        "feed_id": "fd_12345",

        "title": "도쿄 여행기",

        "author": {

          "user_id": "usr_99",

          "name": "홍길동"

        },

        "likes_count": 142

      }

    ],

    "next_cursor": "fd_12344",

    "has_more": true

  }

}