Skip to content

feat: 내 서재 API - publisher 응답 추가 및 도서 단건 조회 신설 #114

Description

@Byesol

🎯 구현 목적

  • 마이페이지 내 서재 화면에서 서재 목록 카드와 책 상세 헤더에 출판사를 함께 표시하고, 딥링크·새로고침으로 책 상세 화면에 바로 진입해도 상단을 채울 수 있도록 도서 단건 조회 API를 제공한다.

📝 작업 내용

  • BookActivityResponsepublisher 필드 추가 (GET /api/books/my-library, GET /api/books/popular, GET /api/home/books가 함께 영향받음)
  • GET /api/books/{bookId} 신규 엔드포인트 추가 — BookDetailResponse(bookId, title, author, publisher, pageCount, coverImageUrl, passageCount, opinionCount, myStatus, myCurrentPage) 반환
  • 비로그인 요청은 myStatus/myCurrentPage를 제외한 나머지 필드만 반환 (Soft Authentication)
  • 존재하지 않는 bookId는 404 (BOOK_404_1)

💡 참고 사항

  • 기준: dev 스펙(api-dev.pallang.co.kr/v3/api-docs, 2026-08-16 조회) 기반 프론트엔드 리포트
  • publisher는 이미 Book.publisher로 저장되어 있어 조회 대상 필드만 추가하면 됨. GET /api/books/recent는 이미 BookResponse 기반이라 publisher가 포함되어 있어 별도 작업 불필요
  • myStatus는 도서 단건 조회에 포함해 UserBookStatus 조회용 별도 엔드포인트를 만들지 않아도 되게 한다 (책 상세 진입 시 요청 1회로 완료)
  • 현재 ReadingStatus는 READING/PLANNED만 존재. FINISHED 등 상태 확장은 이 이슈 범위 밖 (별도 UserBookStatus 관련 이슈)

Metadata

Metadata

Assignees

Labels

✨ Feature새로운 기능 추가📡 APIAPI 명세 및 엔드포인트 관련 작업

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions