Notion Integration トークンが無効になっていた？

2025-11-23

Notion Integration トークンが無効になっていた？

なんか、ブログの記事とかを整理したいたらある日を境にうまくNotionAPIと連携ができてないことが発覚！

ちょっと時間をさいしてリサーチしてみた。

※基本的にはAIを活用してリサーチとすり合わせを行っています。

どうやら、前回にNotion DBのトークンを更新していた際にタイポしてたっぽいのが原因だった。

本当にタイポでのエラーってなくならないよね。。。。

（自分が気をつければいいだけなのにね。。）

以下が調べた項目

1. 入力ミス

古いトークンと新しいトークンを比較してみた：

古い: ntn_I950919813OaUCPgfGKRLEpcFcDYAImgLIwqKrReKZydM5
新: ntn_i9509198130jzNTadkhjeIyVImS9SaIkjejsZQhpX847UU
     ↑ここが違う（I vs i）

大文字の I と小文字の i が違っていた！

紛らわしい文字：

  • I（大文字アイ）vs l（小文字エル）vs 1（数字の1）
  • O（大文字オー）vs 0（数字のゼロ）
  • 8（数字の8）vs B（大文字ビー）

この辺は今後の要チェックリスト行き

2. トークンが再生成された

Notionの設定画面で「シークレットを再生成」ボタンを押すと、古いトークンは即座に無効化されて新しい方が有効になる（ここで僕はミスったっぽい）

3. ワークスペースからIntegrationが削除された

特定のワークスペースからIntegrationの接続が解除されると、そのワークスペースのデータにアクセスできなくなるらしいが今回はこれではない。

4. Notionアカウントの問題

  • アカウントがロックされた
  • 支払い情報の問題（有料プランの場合）
  • セキュリティ上の理由でNotionがトークンを無効化

というのがあるっぽいが、有料課金はしてないしロックされてない。セキュリティの理由はなかった。

この辺で、トークンに期限があるのか？とか思って調べた。でもシンプルにそんなものはないよねw

当たり前だけど 「Notion Integrationのトークンには有効期限がなかった」

一度発行されたトークンは、以下の条件を満たす限り永久に有効らしい

  • Integration が削除されていない
  • トークンが再生成されていない
  • ワークスペースとの接続が維持されている

いや、普通に考えて当たり前のことだね

今後のために、ベストプラクティスはこれかな

1. トークンのコピーは必ず「コピー」ボタンを使う

❌ スクリーンショットを見て手動入力
✅ 「コピー」ボタンでクリップボードにコピー

普通に手動は悪。コピーや自動で入力できるようにしよう。

2. トークンは安全に保管

❌ GitHubにコミット
❌ Slack/メールで共有
✅ 環境変数に保存
✅ パスワードマネージャーに保管

これは仕事では当たり前のこと。 プライベートでもちゃんとやろう。

3. 定期的なローテーション

セキュリティのため、数ヶ月〜1年に1回程度トークンを再生成することがいいかも そうすることで、やり方など記憶に残る

今回の教訓

今回はタイポという人類が足掻いても一度はぶちあた流ことが原因でした。Notion側で何か問題があったわけではありません！

次回からは：

  1. 「コピー」ボタンを使う
  2. 401エラーが出たら、まずトークンの文字列を確認
  3. ローカルで先にテストする
ブログ一覧に戻る