OAuth 换取访问令牌

用授权码或刷新令牌换取 OAuth 访问令牌（HTTP Basic 客户端凭据）。

通过官方版本化 Notion API 管理页面、块、数据源/数据库、评论、文件上传、视图、用户与搜索，并支持 OAuth 与异步任务。完整边界为官方 OpenAPI 快照中的 49 个 Endpoint；工作区数据为私有用户内容，Pontx 不代理、缓存或聚合，调用方使用本地 SDK/CLI 直连。

请求

operationId: createToken
服务器: https://api.notion.com
认证: bearerAuth, basicAuth

请求参数

`Notion-Version`

headerstring必填

请求使用的 API 版本日期；当前最新版本为 2026-03-11。

2026-03-11

Body 参数

string必填

响应

`200`

objectapplication/json

请求成功。

字段: access_tokenbot_idduplicated_template_idownerrefresh_tokenrequest_idtoken_typeworkspace_iconworkspace_idworkspace_name

`400`

error_oauth_400application/json

请求参数无效。

`401`

error_oauth_401application/json

未认证或令牌无效。

`403`

error_oauth_403application/json

无权限访问该资源。

`500`

error_oauth_500application/json

上游服务内部错误。

{
  "access_token": "example content",
  "bot_id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
  "duplicated_template_id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
  "refresh_token": "example content",
  "request_id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
  "token_type": "bearer",
  "workspace_icon": "https://example.com"
}