Tokenを作成

POST/v1/oauth/token _

サードパーティサービスが Notion での認証に使用できるアクセストークンを作成します。

📘

このエンドポイントを使用してパブリック統合を作成する手順については、認証ガイドをご覧ください。リンクプレビューのトークンを作成する方法については、リンクプレビューガイドを参照してください。

Requestパラメータ

grant_type

string

必須

定数文字列: "authorization_code"。

code

string

必須

サービスで認証するために Notion が生成する一意のランダムコードで、ユーザーが OAuth フローを開始したときに生成されます。

redirect_uri

string

必須

"redirect_uri"統合の認証設定の OAuth ドメインと URI セクションで提供された.

external_account

object

可選

リンクプレビュー統合を構築する場合にのみ必要です(それ以外の場合は無視されます)。keyとプロパティを持つオブジェクトname。keyアカウントの一意の識別子である必要があります。Notion はを使用して、keyユーザーが同じアカウントに再接続しているかどうかを判断します。nameユーザーがサービスでの認証に使用したアカウントを知るための何らかの方法である必要があります。ユーザーが以前に統合で Notion を認証し、key同じであるがname異なる場合、Notion はname統合に関連付けられたを更新します。

key

string

必須

name

string

必須

{
  "grant_type": "string",
  "code": "string",
  "redirect_uri": "string",
  "external_account": {
    "key": "string",
    "name": "string"
  }
}

サンプルコード

Response

OK(200)

不正なRequest(400)

HTTPステータスコード: 200

コンテンツ形式: JSONapplication/json

access_token

string

必須

bot_id

string

必須

duplicated_template_id

null

必須

owner

object

必須

workspace

boolean

必須

workspace_icon

string

必須

workspace_id

string

必須

workspace_name

string

必須

{
  "access_token": "e202e8c9-0990-40af-855f-ff8f872b1ec6c",
  "bot_id": "b3414d659-1224-5ty7-6ffr-cc9d8773drt601288f",
  "duplicated_template_id": null,
  "owner": {
    "workspace": true
  },
  "workspace_icon": "https://website.domain/images/image.png",
  "workspace_id": "j565j4d7x3-2882-61bs-564a-jj9d9ui-c36hxfr7x",
  "workspace_name": "Ada's Notion Workspace"
}

最終更新： 2 years ago