NotionのAPIを使用する為の準備手順

NotionのAPIを活用すると、iOSの「ショートカット」やWindowsのPowerAutomateなどと組み合わせて、いろいろなハックが捗る。
この記事では、APIの利用を始めるためのキーの取得方法と設定方法について解説する。

シークレットキーを発行する

まず、 https://developers.notion.com/ にアクセスする。
続いて、右上の「View my integrations」を押す。
続くページで「新しいインテグレーションを作成する」を押す。
任意の名前をつけて、「送信」を押す。
下記の画面になればシークレットキーの発行は完了だ。 「表示」を押せば、secret_から始まる暗号キーが表示されるので、必要に応じてメモしておこう。
ただし、この時点ではまだこのキーで読み込み・書き込みできるNotionのページが無い状態だ。 併せて、特定のページをAPI経由で操作できるように設定する方法を解説する。

Notion上で発行したシークレットキーに権限を付与する

Notionの任意のページを開き、右上の「•••」メニュー内の「コネクト」から、先ほどシークレットキー作成時に名前をつけたインテグレーションを探して選択する。
これで、このページおよびこのページ以下の全てのページが、先ほどのシークレットキーで読み込み・書き込みが可能になった。 ページだけでなくデータベースにも同様にコネクトの設定が可能なので、API経由で操作したい領域にはこの設定を施しておくようにしよう。