ブロックを取得
GET/v1/blocks/{block_id}指定された ID を使用してBlock オブジェクトを取得します。
📘
ブロックに
has_children: truekey が含まれている場合は 、Retrieve block childrenエンドポイントを使用して、子のリストを取得します。
📘統合機能
このエンドポイントでは、コンテンツの読み取り機能を備えた統合が必要です。コンテンツの読み取り機能なしでこの API を呼び出そうとすると、403 ステータス コードを含む HTTP 応答が返されます。統合機能の詳細については、機能ガイドを参照してください。
エラー
ブロックが存在しない場合、または統合がブロックにアクセスできない場合は、404 HTTP 応答を返します。
リクエストがリクエスト制限を超えた場合、400 または 429 HTTP レスポンスを返します。
Request
Pathパラメータ
block_id
string
必須
Notion ブロックの識別子
Request samples
Response
200 Success - Retrieve a block(200)
200 Success - Retrieve a block
HTTP Code: 200
Content Type : JSONapplication/json
データ構造
object
string
必須
id
string
必須
parent
object
必須
type
string
必須
page_id
string
必須
created_time
string
必須
last_edited_time
string
必須
created_by
object
必須
object
string
必須
id
string
必須
last_edited_by
object
必須
object
string
必須
id
string
必須
has_children
boolean
必須
archived
boolean
必須
type
string
必須
heading_2
object
必須
rich_text
array [object {5}]
必須
color
string
必須
is_toggleable
boolean
必須
例成功例
{
"object": "block",
"id": "c02fc1d3-db8b-45c5-a222-27595b15aea7",
"parent": {
"type": "page_id",
"page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
},
"created_time": "2022-03-01T19:05:00.000Z",
"last_edited_time": "2022-03-01T19:05:00.000Z",
"created_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"last_edited_by": {
"object": "user",
"id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
},
"has_children": false,
"archived": false,
"type": "heading_2",
"heading_2": {
"rich_text": [
{
"type": "text",
"text": {
"content": "Lacinato kale",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Lacinato kale",
"href": null
}
],
"color": "default",
"is_toggleable": false
}
}最終更新： 2 years ago