バージョニング
バージョニング
Notion-Version
ヘッダーを含めてバージョンを設定します。curl https://api.notion.com/v1/users/01da9b00-e400-4959-91ce-af55307647e5 \
-H "Authorization: Bearer secret_t1CdN9S8yicG5eWLUOfhcWaOscVnFXns"
-H "Notion-Version: 2022-06-28"
// Prior to version 2021-05-13, the rich text property is called "text"
"properties": {
"Description": {
"type": "text"
"text": [ ... ]
}
}
// In version 2021-05-13, the rich text property is now called "rich_text"
"properties": {
"Description": {
"type": "rich_text"
"rich_text": [ ... ]
}
}
text
を使用してテキスト プロパティを設定し続けます。新しいバージョンにアップグレードしたら、 rich_text
を使用して同じテキスト プロパティを設定する必要があります。text
レスポンスが返されますが、新しいバージョンではrich_text
になります。🚧必須ヘッダー
すべてのリクエストに Notion-Version
ヘッダーを含めることを強くお勧めします。これにより、Notion API がコードが期待するものと一致することが保証されます。2021 年 6 月 1 日以降、すべての API 呼び出しにNotion-Version
ヘッダーを含める必要があります。
📘バージョニングは、後方互換性のない変更のみを対象としています
新しい API エンドポイントの追加や、既存の API エンドポイントの応答への新しいオブジェクトの追加など、API への新機能や追加については、新しいバージョンはありません。現在使用している API のバージョ ンで新しい機能を利用できます。
v1
が含まれていることにお気づきでしょうか。これは、上記のバージョンアップとは関係ありません。これらの URL を変更するつもりはありません。更新日時 2023-04-28 06:43:29