[WORKSOUT] 숏폼 상세

화면 정보

Screen ID	Screen Title	Screen Path
FEED-SHORT-01	숏폼 상세	`/feed/shortform/{shortformId}`

짧은 동영상/이미지 시퀀스 형태의 숏폼 콘텐츠 상세 화면. 세로형 미디어 자동 재생, 상품 태그, 숏폼 더보기로 구성된다. HBLAB/ByteDance 숏폼 시스템과 연동되며 앱에서만 접근 가능하다. (구 화면 코드: HM_125_Shortform_Detail)

요소	기준
헤더 제목	어드민 설정 숏폼 제목
하트 버튼	로그인 사용자만 사용. 탭 시 찜 상태 토글
공유 버튼	현재 숏폼 상세 URL 공유, OS 기본 공유 사용. 단, 숏폼은 앱 전용 공유 — 공유 링크는 앱에서만 접근 가능(웹 접근 불가)
비로그인 찜하기	로그인 화면으로 이동

운영 기준

카드 표시 정보: 이미지(thumbnailUrl), 브랜드명, 상품명, 가격

숏폼은 어드민을 통해 등록되며 관리자가 승인 시 노출을 설정할 수 있다.
숏폼 콘텐츠의 게시 기준은 숏폼 운영 정책에 기반한다.
상품 태그는 최대 8개까지 설정 가능하다.
콘텐츠 공유 시 링크와 썸네일 이미지 형태로 공유되나, 숏폼은 앱에서만 접근 가능하다 (웹 공유 링크로 접근 시 앱 설치 유도만 되고 웹에서는 열리지 않음).

엔드포인트: GET /v1/shortform/detail/{shortformId}
호출 시점: 숏폼 상세 화면 진입 시
활용 필드:
- payload.content[0].title — 헤더 제목
- payload.content[0].status — APPROVED 여부 확인
- payload.content[0].exposureStatus — 노출 가능 여부
- mediaList[].orderNo — 미디어 정렬 순서
- mediaList[].fileType — video / image 구분
- mediaList[].byteplusUrl — 비디오 재생 URL
- mediaList[].shortformThumbnailUrl — 썸네일 이미지
- mediaList[].vid — 비디오 식별값
- productList[].productId — 상품 식별값
- productList[].orderNo — 상품 태그 순서
- productList[].brandName / productName / currentPrice / thumbnailUrl — 상품 카드 표시
운영 메모: 상세 응답이 payload.content[] 배열 구조이며, 화면에서는 일반적으로 첫 번째 항목(content[0])을 현재 상세 데이터로 사용한다.

엔드포인트: GET /v1/shortform/detail/{shortformId} (원문 기준)
호출 시점: 숏폼 상세 로드 후 / 무한 스크롤 추가 로드 시
필터링: 현재 숏폼 제외, 어드민 업로드 최신순
운영 메모: 원문에서 상세 조회와 더보기 추천이 동일 엔드포인트로 기재되어 있다. 실제 구현에서는 별도 추천/목록 API가 사용될 수 있으며, 페이지네이션 계약서를 서버 명세 기준으로 확인해야 한다.

항목	내용
숏폼 더보기 실제 API	상세 조회와 더보기 추천이 원문에서 동일 엔드포인트로 기재되어 있어, 별도 페이지네이션 API 존재 여부를 백엔드 계약서로 재확인 필요