認証

リクエストは HTTPAuthorizationヘッダーを使用して、操作の認証と承認の両方を行います。Notion API は、このヘッダーでベアラー トークンを受け入れます。ベアラー トークンは、統合を作成するときに提供されます。パブリック OAuth 統合を作成している場合、統合はユーザーが OAuth フローを完了するたびにベアラー トークンも受け取ります。

cURL

curl 'https://api.notion.com/v1/users' \
  -H 'Authorization: Bearer '"$NOTION_ACCESS_TOKEN"'' \
  -H "Notion-Version: 2022-06-28"

Notion 内では、ボットに起因する統合によって行われた更新がユーザーに表示されます。ボットの名前とアバターは、統合設定で制御されます。

Notion SDKを使用すると、ベアラー トークンを 1 回渡してClient を初期化し、クライアントを使用して複数の認証済みリクエストを送信できます。

JS 用 SDK の概念

const { Client } = require('@notionhq/client');

const client = new Client({ auth: process.env.NOTION_ACCESS_TOKEN });

詳細については、認証ガイドをご覧ください。