ovahub알림 메시지 조회
/api/v1/messages
조직 메시지와 읽지 않은 메시지 수를 조회합니다. 페이지당 8건입니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
curl "https://tovahub.com/api/v1/messages?page=1" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
응답 예시
{
"userId": "507f1f77bcf86cd799439013",
"through": "2026-11-07T12:00:00.000Z",
"messages": [],
"unreadCount": 0,
"page": 1,
"pageSize": 8,
"totalCount": 0,
"totalPages": 1
}매개변수
page쿼리 · 선택string
쿼리 문자열로 표현한 양의 정수이며 기본값은 "1"입니다. totalPages를 기준으로 페이지를 이동하세요.
응답
HTTP 상태 200
페이지 번호로 조직 메시지를 조회합니다.
userIdstring (ObjectId)인증된 사용자 식별자입니다.
throughstring (ISO 8601)mark_messages_read에 전달할 메시지 조회 시점의 기준 시각입니다.
messagesarray선택된 필드만 포함한 메시지 기록이며 serverId와 dedupeKey는 포함하지 않습니다.
messages[]._idstring (ObjectId)메시지 식별자입니다.
messages[].ticketIdstring (ObjectId) | null연결된 지원 문의 식별자이며, 있는 경우에만 제공됩니다.
messages[].typestringserver_expiring, server_expired, renewal_failed, balance_gift, admin_message 또는 ticket_reply입니다.
messages[].serverNamestring | null연결된 서버 이름이며, 있는 경우에만 제공됩니다.
messages[].expiresAtstring (ISO 8601) | null연결된 서비스 만료 시각이며, 있는 경우에만 제공됩니다.
messages[].daysLeftnumber | null알림에 표시된 남은 일수이며, 있는 경우에만 제공됩니다.
messages[].amountstring | null알림 금액이며, 있는 경우에만 제공됩니다.
messages[].messagestring | null메시지 본문이며, 있는 경우에만 제공됩니다.
messages[].readAtstring (ISO 8601) | null읽은 시각 또는 null입니다.
messages[].createdAtstring (ISO 8601)메시지 생성 시각입니다.
unreadCountnumber조직 전체에서 읽지 않은 메시지 수입니다.
pagenumber사용 가능한 페이지 범위로 제한된 실제 페이지 번호입니다.
pageSizenumber (8)고정 페이지 크기입니다.
totalCountnumber전체 메시지 수입니다.
totalPagesnumber전체 페이지 수입니다. 목록이 비어 있어도 최소 한 페이지입니다.