채팅방 메시지 이력 조회

GET

/api/v1/chats/{chatRoomId}/messages

커서 기반으로 과거 메시지를 조회합니다.
cursor가 없으면 최신 메시지부터, 있으면 해당 ID 이전 메시지를 반환합니다.

실시간 메시지 수신

실시간으로 새로운 메시지를 받으려면 WebSocket 구독이 필요합니다:

구독 경로: /user/sub/chat/{chatRoomId}

프로토콜: STOMP over WebSocket

인증: CONNECT 프레임에 JWT 토큰 필요

이 API는 과거 메시지 이력 조회 전용이며, 실시간 메시지는 WebSocket 구독으로만 수신됩니다.

페이지네이션

커서 기반 페이지네이션 사용

nextCursor가 null이면 마지막 페이지

hasNext로 다음 페이지 존재 여부 확인

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200

application/json

조회 성공

Body

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/api/v1/chats/1/messages?size=50&cursor=100' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 페이로드 예시(다음 페이지 존재)

{
    "success": true,
    "status": 200,
    "data": {
        "content": [
            {
                "id": 2,
                "messageType": "USER",
                "content": "서울 3박 4일 여행 계획을 짜주세요",
                "messageContentType": "TEXT",
                "mediaUrl": null,
                "createdAt": "2025-01-15T10:31:00"
            },
            {
                "id": 1,
                "messageType": "ASSISTANT",
                "content": "서울 3박 4일 여행 계획을 제안드립니다.",
                "messageContentType": "TEXT",
                "mediaUrl": null,
                "createdAt": "2025-01-15T10:32:00"
            }
        ],
        "nextCursor": 1,
        "hasNext": true,
        "size": 2
    }
}

Modified at 2025-12-19 08:15:40

현재 로그인한 사용자 이름 조회

TripPlanCreateRequest

채팅방 메시지 이력 조회

실시간 메시지 수신#

페이지네이션#

Request

Responses

실시간 메시지 수신

페이지네이션