docs : API 문서 자동 업데이트

.openapi-snapshot.json

@@ -1,5 +1,5 @@
 {
-  "POST /seatViews/contents": "dfed0f4acb427c4a44e5bdf6dc101b76",
+  "POST /seatViews/contents": "2345868e2b1591676fcfd0eca3d552e0",
   "POST /member/setup": "728b6ff046ca592ba1958ac63ea7198e",
   "PATCH /member/setup": "87ac4ece31e4f0ffd0635412ebc96a84",
   "POST /journals/{journalId}/scraps": "6037101ce36b5d31c10cc7caa4e9b68b",
@@ -30,19 +30,24 @@
   "GET /community/posts/{postId}": "b9a01d791105fe21bf0e3048d0bce5c3",
   "PATCH /community/posts/{postId}": "84ff97090c560b44f3d94518479f61be",
   "DELETE /community/posts/{postId}": "7bb91238f9c882914089348793844a90",
-  "GET /seatViews/{seatViewId}": "9f0fb3cb2de181cb9210d5a52f77fe66",
-  "GET /seatViews/normal/gallery": "2aa411351c208ef69b3919f1311b60c6",
-  "GET /seatViews/hashtag/gallery": "b04d22a484dcc1ebb0700821ef1dd38a",
+  "GET /seatViews/{seatViewId}": "106d949056194de5622ff7b83d5eca53",
+  "GET /seatViews/normal/gallery": "6b25ea3b1e0ba52175a25f8c52a3b1fc",
+  "GET /seatViews/hashtag/gallery": "b6e1dc33fc28814f1efd02605493f990",
   "GET /search/history": "403dc37c83b9ecfc8f69691c7218cecb",
   "GET /s3/seatView/presigned": "0d12684ebb4f3573b4b31f88d30749ad",
   "GET /s3/journal/presigned": "71777e68ac940fb41006445dea4e4c41",
   "GET /report/main": "94bb11d0cbb26428ff3f90b147f3711e",
   "GET /member/team": "36647a5cf883d6b60ce4ead8afd2a06d",
+  "GET /member/profile": "a9ce5c5fa05d73dbd7e0ff1e0257af6a",
   "GET /login/page": "15fcf5fef7ff48943456060914acd866",
   "GET /journals/summary": "5c86b4cb6f777da415c51cf1b375534b",
   "GET /journals/search": "90602230738f0d06446a79f6c65157a5",
   "GET /journals/schedule": "ade3184bac14d7c7000fa0160a2c7502",
+  "GET /journals/popular": "99c72aed811c6a2b005684ae592e0099",
   "GET /journals/my": "6a247861cdf342a3af4c02f4283a94f6",
+  "GET /journals/my/scrapped": "08741972c4961cc8745dc32586a4679a",
+  "GET /journals/my/liked": "b47cf95133e80f87e12c71fed688ea38",
+  "GET /journals/my/commented": "78476bfb293e46429d6e59e328fddade",
   "GET /journals/feed": "be46219f75bfb4ba384f9ed9a9a070ab",
   "GET /journals/detail/{journalId}": "2dc12381e67c0950de5f04058ec529ed",
   "GET /journals/calendar": "73818ffd0555a80a7d336870a7b30a1e",
@@ -60,6 +65,7 @@
   "GET /api/kbo/games/with-boxscore": "ca532b1e5fc84ff048463284871791b4",
   "GET /api/kbo/games/stats": "c291d639f3372ab38ba7be20b6657ce7",
   "DELETE /search/history/{searchHistoryId}": "89e24b8c5389901547598f78ee43f314",
+  "DELETE /member/me": "2d3159beabf0f8ad7c595650244836c1",
   "DELETE /community/posts/{postId}/scraps": "e458d5d99ebed257dc4938744cac608b",
   "DELETE /community/comments/{commentId}": "bc466085e13e8fdfd78226a59edcecbd"
 }

SUMMARY.md

@@ -71,3 +71,16 @@
 ## 에러 코드 <a href="#error" id="error"></a>
 
 * [에러 코드 목록](error/README.md)
+
+<!-- AUTO-GENERATED-START -->
+
+## 직관일지
+
+* [인기 직관 일지 목록 조회](journal/get-journals-popular.md)
+
+## 회원
+
+* [회원 탈퇴](member/delete-member-me.md)
+* [회원 초기 설정 (닉네임 + 응원팀)](member/post-member-setup.md)
+
+<!-- AUTO-GENERATED-END -->

journal/get-journals-popular.md

@@ -0,0 +1,46 @@
+<!-- AUTO-GENERATED -->
+
+## 인기 직관 일지 목록 조회
+
+### 개요
+
+좋아요 10개 이상인 공개 직관 일지 목록을 조회합니다.
+
+✔ 최신순(createdAt DESC)으로 정렬되어 반환됩니다.
+✔ page는 0부터 시작합니다. (0=첫 페이지)
+✔ size는 한 페이지에서 가져올 일지 수를 의미합니다.
+✔ hasNext가 true이면 다음 페이지 요청이 가능합니다.
+
+### 엔드포인트
+
+`GET /journals/popular`
+
+### 인증
+
+🔒 JWT 인증 필요
+
+### 요청 (Request)
+
+#### Headers
+
+| 헤더 | 값 | 필수 |
+|------|------|------|
+| Authorization | Bearer {token} | ✅ |
+
+#### Query Parameters
+
+| 파라미터 | 타입 | 필수 | 설명 | 예시 |
+|----------|------|------|------|------|
+| page | Integer |  | 조회할 페이지 번호 (0부터 시작) | 0 |
+| size | Integer |  | 한 페이지당 일지 개수 | 10 |
+
+### 응답 (Response)
+
+#### 200 인기 직관 일지 목록 조회 성공
+
+| 필드명 | 타입 | 설명 |
+|--------|------|------|
+| content | Object[] | 조회된 데이터 목록 |
+| hasNext | Boolean | 다음 페이지가 존재하는지 여부 |
+| page | Integer | 현재 페이지 번호 |
+| size | Integer | 페이지 크기 |

member/delete-member-me.md

@@ -0,0 +1,27 @@
+<!-- AUTO-GENERATED -->
+
+## 회원 탈퇴
+
+### 개요
+
+카카오 연동을 해제하고 회원을 탈퇴 처리합니다. 작성한 게시글/댓글은 '알 수 없는 사용자'로 표시됩니다.
+
+### 엔드포인트
+
+`DELETE /member/me`
+
+### 인증
+
+🔒 JWT 인증 필요
+
+### 요청 (Request)
+
+#### Headers
+
+| 헤더 | 값 | 필수 |
+|------|------|------|
+| Authorization | Bearer {token} | ✅ |
+
+### 응답 (Response)
+
+#### 200 OK

member/post-member-setup.md

@@ -0,0 +1,62 @@
+<!-- AUTO-GENERATED -->
+
+## 회원 초기 설정 (닉네임 + 응원팀)
+
+### 개요
+
+회원 가입 후 최초 1회에 한해 닉네임과 응원팀을 한 번에 설정합니다.
+
+⚠️ 응원팀은 한 번 설정하면 변경할 수 없습니다.
+
+### 엔드포인트
+
+`POST /member/setup`
+
+### 인증
+
+🔒 JWT 인증 필요
+
+### 요청 (Request)
+
+#### Headers
+
+| 헤더 | 값 | 필수 |
+|------|------|------|
+| Authorization | Bearer {token} | ✅ |
+| Content-Type | application/json | ✅ |
+
+#### Body
+
+| 필드명 | 타입 | 필수 | 설명 | 예시 |
+|--------|------|------|------|------|
+| nickname | String |  | 설정할 닉네임 | 야구천재 |
+| teamShortCode | String |  | 응원팀 shortCode | LG |
+
+### 응답 (Response)
+
+#### 200 회원 정보 설정 완료
+
+| 필드명 | 타입 | 설명 |
+|--------|------|------|
+| code | String |  |
+| message | String |  |
+| data | Object |  |
+
+#### 응답 예시
+
+```json
+{
+  "code": "MEMBER_SETUP_SUCCESS",
+  "message": "회원 정보 설정이 완료되었습니다.",
+  "data": null
+}
+```
+
+### 실패 (Error)
+
+| 코드 | 설명 |
+|------|------|
+| 400 | 잘못된 요청 |
+| 404 | 리소스를 찾을 수 없음 |
+| 409 | 이미 팀이 설정됨 |
+| 500 | 서버 내부 오류 |