Opinion

흔적 작성 (직접 입력)

Passage(신규 생성 또는 기존 병합) + Opinion + Decoration을 원자적으로 생성합니다. passageId가 없으면 새 Passage를 만들고, 있으면 해당 Passage에 병합합니다(Q-06). groupId를 지정하면 그 모임 전용 흔적/대목이 되며(요청자는 모임원이어야 함), 생략하면 기존처럼 전역 공개로 생성됩니다. passageId와 groupId를 함께 지정한 경우 기존 대목의 소속 모임과 정확히 일치해야 합니다. OCR 입력은 별도 플로우이며 이 API는 직접 입력만 지원합니다. Authorization: Bearer {accessToken} 헤더로 인증합니다.

post/api/opinions

Request

Base URL: https://api-dev.pallang.co.kr
URL: https://api-dev.pallang.co.kr/api/opinions
Auth: HTTP bearer

Request body

bookIdinteger required

pageNumberinteger

quotedTextstring required

isSpoilerboolean

passageIdinteger nullable

병합할 기존 대목 ID. 없으면 새 대목을 생성합니다.

groupIdinteger nullable

모임 ID. 없으면 전역 공개 흔적/대목으로 생성됩니다.

contentstring required

Example request

{
  "bookId": 1,
  "pageNumber": 87,
  "quotedText": "우리는 모두 이야기를 찾아 헤맨다.",
  "passageId": 5,
  "groupId": 1,
  "content": "이 문장에서 작가의 의도가 느껴져서 좋았어요.",
  "decorations": [
    {
      "startOffset": 3,
      "endOffset": 12,
      "effectType": "HIGHLIGHT",
      "color": "#FFE08A"
    }
  ]
}

Response

흔적 생성 성공

Changes

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