대목(Passage)

특정 페이지의 대목 + 꾸밈 병합 결과 조회

같은 페이지에 여러 대목이 있으면 모두 반환합니다(대목 전환). 각 대목에는 좋아요 많은 순 최대 3개, 겹치지 않는 꾸밈만 병합되어 포함됩니다. 스포일러로 표기된 대목(isSpoiler=true)도 quotedText/decorations를 그대로 내려줍니다 — 블러 처리 후 [버튼]을 누르면 즉시 확인 가능해야 하므로, 블러/확인 전환은 서버 왕복 없이 프론트에서 isSpoiler 플래그로 처리합니다. groupId를 지정하면 그 모임 전용 대목만(요청자는 모임원이어야 함), 생략하면 전역 공개 대목만 조회합니다.

get/api/books/{bookId}/pages/{page}/passages

Request

  • Base URL: https://api-dev.pallang.co.kr
  • URL: https://api-dev.pallang.co.kr/api/books/{bookId}/pages/{page}/passages
  • Auth: HTTP bearer

Path parameters

bookIdinteger required

도서 ID

pageinteger required

페이지 번호

Query parameters

groupIdinteger

모임 ID. 없으면 전역 공개 대목 기준으로 조회합니다.

Response

조회 성공 (해당 페이지에 대목이 없으면 빈 배열)

Changes

No recorded changes to this operation across all 1 revision of this API.