광고연구소

메시지

OnSureLab

유저와 외주 업체 간 메시지를 주고받는 채팅 API입니다.

POST

메시지 전송

엔드포인트
POST /api/onsurelab/executions/:id/messages
요청 Body
필드타입필수설명
textstring
필수
메시지 내용
filesstring[]-첨부파일 URL 배열 (미리 파일 업로드 API로 올린 URL)
senderstring-USER / VENDOR / SYSTEM (기본: USER)
성공 응답 (201)
{
  "success": true,
  "data": {
    "id": "msg_abc123def4",
    "sender": "USER",
    "text": "제작 브리프 전달드립니다.",
    "files": ["https://storage.example.com/files/brief.pdf"],
    "timestamp": 1705312800000,
    "createdAt": "2025-01-15T10:00:00.000Z"
  }
}
GET

메시지 목록 조회

커서 기반 페이징

엔드포인트
GET /api/onsurelab/executions/:id/messages
파라미터
파라미터타입필수설명
cursorstring-마지막 메시지 ID (커서)
limitnumber-조회 개수 (기본: 50, 최대: 100)
성공 응답 (200)
{
  "success": true,
  "data": {
    "messages": [
      {
        "id": "msg_001",
        "sender": "USER",
        "text": "제작 브리프 전달드립니다.",
        "files": [],
        "timestamp": 1705312800000,
        "createdAt": "2025-01-15T10:00:00.000Z"
      },
      {
        "id": "msg_002",
        "sender": "VENDOR",
        "text": "확인했습니다. 3일 내 초안 전달드리겠습니다.",
        "files": [],
        "timestamp": 1705316400000,
        "createdAt": "2025-01-15T11:00:00.000Z"
      }
    ],
    "hasMore": false,
    "nextCursor": null
  }
}