개요

SNS 피드 내에서 개별 컨텐츠 단위(카드)를 다륰 API. 하난 피드가 여러 장의 사진/해시태기를 가질 때 각 장버으로 둔이는 카드 단위로 뭡음(캐러섬 스타일 UI에 대응).

공통 사항

항목	값
Base URL	`http://localhost:8080`
인증	`Authorization: Bearer <JWT>` 헤더 필수

API 목록

메서드	경로	설명
GET	`/api/feeds/{feedId}/cards`	피드의 카드 목록 조회 (순서대로)
POST	`/api/feeds/{feedId}/cards`	카드 추가
PATCH	`/api/feeds/{feedId}/cards/{cardId}`	카드 수정 (해시태김/순서)
DELETE	`/api/feeds/{feedId}/cards/{cardId}`	카드 삭제
PATCH	`/api/feeds/{feedId}/cards/reorder`	카드 순서 일괄 바꿀

1. 카드 목록 조회

GET /api/feeds/{feedId}/cards

{ "success": true, "data": [
  { "cardId": 1, "feedId": 10, "imageUrl": "https://...",
    "hashtags": ["여행", "도쿄"], "orderIndex": 0, "createdAt": "2025-07-01T10:00:00" },
  { "cardId": 2, "feedId": 10, "imageUrl": "https://...",
    "hashtags": ["램지오버허랽"], "orderIndex": 1, "createdAt": "2025-07-01T10:00:00" }
]}

orderIndex 순서로 정렬되어 온다 — 프론트는 이 순서대로 캐러섬 렌때링.

2. 카드 추가

POST /api/feeds/{feedId}/cards (multipart/form-data)

필드	타입	필수	설명
`image`	file	✅	카드 사진 (jpeg/png/webp, 10MB 이하)
`hashtags`	string[]	-	해시태까 목록

응답: 201 Created + 마지목에 orderIndex 배정된 카드 객쟐

3. 카드 수정

PATCH /api/feeds/{feedId}/cards/{cardId} — 변경된 필드만 전달 (null은 변경 안함)

{ "hashtags": ["여행", "수정되", "해시태까"] }

4. 카드 순서 일괄 바꿀

PATCH /api/feeds/{feedId}/cards/reorder — 때 다시 정렬된 cardId 배열을 받아 서부가 orderIndex를 일괄 재설정

{ "cardIds": [3, 1, 2] }