댓글
댓글 목록 읽기
페이지나 블록의 댓글을 만든 순서로 읽습니다. 댓글 읽기 권한이 필요합니다.
GET
댓글과 답글을 만든 순서로 읽습니다.
댓글 읽기 권한이 필요합니다. 댓글 쓰기는 제공하지 않습니다.
string
필수
Bearer <토큰> 형식입니다. 토큰 자세히 알아보기 →string
선택 항목입니다.
2026-03-11만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.string
필수
페이지 ID나 블록 ID입니다. 형식은 검사하지 않고, 없는 ID는 404입니다.
number
기본값:"100"
1~100입니다.
string
앞 응답의
next_cursor입니다. 다음 댓글의 ID입니다.반환하는 댓글
- 해결한 스레드는 답글까지 목록에서 빠집니다. 댓글 읽기로는 읽을 수 있습니다.
- 지운 댓글은 목록에서 빠집니다. 스레드를 지우면 답글까지 지워집니다.
- 블록이 사라진 댓글을 그 블록 ID로 읽으면
rich_text: []입니다. 페이지 ID나 댓글 읽기로는 글을 받습니다. - 페이지 댓글의
discussion_id는 스레드마다 다릅니다. 답글의discussion_id는 스레드 첫 글과 같습니다. - 휴지통에 있는 행의 댓글은
rich_text: []와original_content_deleted: true로 나옵니다. 되살리면 글이 돌아옵니다.
댓글 객체
하위 문서 카드의 글에 단 댓글은parent가 {문서 ID}.{블록} 형식입니다. 이 ID로 블록을 읽으면 404이지만, 여기의 block_id로는 사용할 수 있습니다.
string
댓글 ID입니다.
object
{ "type": "page_id", "page_id": "..." } 또는 { "type": "block_id", "block_id": "..." }입니다. 답글은 스레드 첫 글과 같습니다.string
스레드 ID입니다. 첫 글의 ID와 같습니다.
string
만든 시각입니다. 분 단위 UTC입니다.
string
고친 시각입니다. 고친 적이 없으면 만든 시각입니다.
object
{ "object": "user", "id": "..." }입니다.object[]
글 조각 배열입니다. 2,000자씩 나뉩니다. 문단 사이에는 줄바꿈 조각이 있습니다. 첨부만 있는 댓글은
[]입니다.object
사람이 쓴 댓글은
{ "type": "user", "resolved_name": "이름" }이고, Bottari가 쓴 댓글은 { "type": "integration", "resolved_name": "보따리" }입니다.boolean
원래 글이나 블록이 사라졌거나 행이 휴지통에 있으면
true입니다.boolean
항상
false입니다.오류
공통 오류는 공통 규칙에서 확인할 수 있습니다.