Tokenを作成

POST

/v1/oauth/token _

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

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.notion.com/v1/oauth/token _' \
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type": "string",
    "code": "string",
    "redirect_uri": "string",
    "external_account": {
        "key": "string",
        "name": "string"
    }
}'

Response Example

200 - 成功例

{
  "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"
}

Requestパラメータ

Request Bodyパラメータapplication/json

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

必須

Examples

Response

🟢200OK

application/json

Body

access_token

string

必須

bot_id

string

必須

duplicated_template_id

null

必須

owner

object

必須

workspace

boolean

必須

workspace_icon

string

必須

workspace_id

string

必須

workspace_name

string

必須

🟠400不正なRequest

更新日時 2023-04-28 10:38:59

認証

ブロックを取得

Tokenを作成

📘#

Requestパラメータ

Response

📘