Notion API を始めるにあたってのTips

先日、Twitter でNotion API がベータ版ではあるものの、公開されたという以下のツイートが流れてきました。

ここでは、Notion APIの始め方からアプリの作成に至るまでをスクラップで垂れ流して進めていきたいと思います。

初期設定

API 作成する前に、次のことを行ってください。

Notion API は次のページで管理します。

上記の管理ページにある New integration をクリックし、

を入力して、Submit ボタンをクリックします。

作成後、トップページで一覧に先ほど作成したAPIの詳細ページで、
Internal Integration Token が作成されます。

Notion API Bot の詳細ページ

先ほどの Bot では、Internal Integration、Public Integration が設定できます。

Internal Integration では、Admin Users としてログインしているワークスペースでは、レビューなく自動的にインストールすることができます。

Public Integration は、レビュー、承認を経てIntegration Gallery へ掲載されることで、全 Notion ユーザーに自作の Bot を公開することができます。

先ほどのBot を作成する方法として、ワークスペースにて、

Setting & Members→Integration ページで作成することができます。

もし、作成したい Bot のアイデアがない場合、次のページでサンプルが公開されています。