본문을 마크다운으로 읽기

curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "page_markdown",
  "id": "exampleRow01",
  "markdown": "# 진행 상황\n\n1월 주문을 <b>확인</b>했습니다.",
  "truncated": false,
  "unknown_block_ids": [],
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version should be `v2`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

pages

{id}

markdown

curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "page_markdown",
  "id": "exampleRow01",
  "markdown": "# 진행 상황\n\n1월 주문을 <b>확인</b>했습니다.",
  "truncated": false,
  "unknown_block_ids": [],
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version should be `v2`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

본문을 마크다운으로 읽습니다. id에 문서 ID를 넣으면 본문 전체를, 블록 ID를 넣으면 그 블록부터 읽습니다. 쓰기는 제공하지 않습니다.

string

필수

Bearer <토큰> 형식입니다. 토큰 자세히 알아보기 →

string

선택 항목입니다. 2026-03-11만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.

string

필수

문서 ID나 블록 ID입니다.

string

기본값:"v2"

v2만 받습니다. v1은 400입니다.

boolean

true와 false를 받지만 결과에는 영향이 없습니다. Bottari 노트는 unknown으로 나옵니다.

string

항상 page_markdown입니다.

string

요청한 ID입니다.

string

본문입니다.

boolean

마크다운으로 쓰지 못한 블록이 하나라도 있으면 true입니다.

string[]

쓰지 못한 블록의 ID입니다. 100개까지 담습니다. 블록 API의 ID와 같습니다.

쓰지 못한 블록은 본문에 <unknown url="..." alt="..." />로 나옵니다. 형식이 없어 쓰지 못한 블록은 그 ID로 다시 읽을 수 있습니다. 권한 때문에 숨은 블록은 다시 읽으면 404입니다. 올린 파일 블록은 서명 주소로 나옵니다. 휴지통에 있는 문서도 읽을 수 있습니다. 휴지통에 있는 인라인 데이터베이스는 본문에서 빠집니다.

오류

상태	`code`	원인
400	`validation_error`	`markdown_version`이 `v2`가 아니거나 `include_transcript`가 불리언이 아닙니다.
404	`object_not_found`	없거나 연동이 읽을 수 없는 문서 또는 블록입니다.

공통 오류는 공통 규칙에서 확인할 수 있습니다.

curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "page_markdown",
  "id": "exampleRow01",
  "markdown": "# 진행 상황\n\n1월 주문을 <b>확인</b>했습니다.",
  "truncated": false,
  "unknown_block_ids": [],
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version should be `v2`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

공통

사용자

검색

데이터베이스와 데이터 소스

페이지

블록

댓글

본문을 마크다운으로 읽기

오류

​오류

오류