1. API 목록

API 목록으로 돌아가기

2. GET: 알림 목록 조회

Table 1. HTTP Request Headers
Name Description

Authorization

Bearer {accessToken} (회원)
HTTP Request
GET /notifications HTTP/1.1
Authorization: Bearer member.access.token
Host: localhost:8080
HTTP Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 516

[ {
  "id" : 1,
  "title" : "팀 알림 제목입니다.",
  "content" : "팀 알림 내용입니다.",
  "targetType" : "TEAM",
  "targetId" : 1,
  "redirectUrl" : "/teams/1",
  "isRead" : false,
  "createdAt" : "2026-06-03T00:21:23.188848583"
}, {
  "id" : 2,
  "title" : "팀 댓글 알림 제목입니다.",
  "content" : "팀 댓글 알림 내용입니다.",
  "targetType" : "TEAM_COMMENT",
  "targetId" : 1,
  "redirectUrl" : "/teams/1",
  "isRead" : false,
  "createdAt" : "2026-06-03T00:21:23.188855841"
} ]
Table 2. Response Body’s Fields
Path Type Description

[]

Array

알림 목록

[].id

Number

알림 ID

[].title

String

알림 제목

[].content

String

알림 내용

[].targetType

String

알림 타입 (TEAM, TEAM_COMMENT, TEAM_AWARDS)

[].targetId

Number

알림 대상 ID

[].redirectUrl

String

이동 URL

[].isRead

Boolean

읽음 여부

[].createdAt

String

알림 생성 시각 (ISO-8601)

3. PATCH: 단일 알림 읽음 처리

Table 3. HTTP Request Headers
Name Description

Authorization

Bearer {accessToken} (회원)
HTTP Request
PATCH /notifications/1 HTTP/1.1
Authorization: Bearer member.access.token
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
HTTP Response
HTTP/1.1 204 No Content
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Table 4. /notifications/{notificationId}
Parameter Description

notificationId

알림 ID

4. PATCH: 전체 알림 읽음 처리

Table 5. HTTP Request Headers
Name Description

Authorization

Bearer {accessToken} (회원)
HTTP Request
PATCH /notifications HTTP/1.1
Authorization: Bearer member.access.token
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded
HTTP Response
HTTP/1.1 204 No Content
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers