接入指南

个人令牌

为自己的工具使用有限的个人 API 权限。

个人访问令牌(PAT)适合你自己控制的脚本和工具。登录 NexusMC 后在账号的 API 令牌管理页创建令牌,勾选实际需要的权限。令牌秘密只在创建或轮换时返回一次;请立即保存到服务端的安全配置中。

调用个人 API时,通过 Authorization: Bearer <token> 发送令牌:

curl -H "Authorization: Bearer $NEXUSMC_PAT" \
  'http://127.0.0.1:4520/v1/personal/resources?limit=10'

此示例要求 resource:read:feed。PAT 可选择资源、帖子、本人资料和组织相关的 14 个 scope;每个操作要求的 scope 写在个人 API 参考中。令牌不会创建网站登录会话,也不能用于账号安全设置、后台、私信或媒体控制。需要代表其他用户访问时,请使用开放平台授权。

不要把令牌放进浏览器代码、URL、文档站配置或公开仓库。轮换会立即使旧秘密失效;调用失败时检查令牌是否过期、是否已撤销,以及 scope 是否覆盖该操作。

创建帖子需要 post:create。以下代码在服务端 Node.js/TypeScript 运行,从环境变量取得秘密:

const token = process.env.NEXUSMC_PAT
if (!token) throw new Error('请先设置 NEXUSMC_PAT')
const response = await fetch('http://127.0.0.1:4520/v1/personal/posts', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Fabric 性能配置交流', body: '分享配置与测试结果。' }),
})
if (!response.ok) throw new Error(`发帖失败:${response.status} ${await response.text()}`)
const result = await response.json() as { ok: true; id: string }
console.log(result.id)

等价的 shell 请求(先在本地安全地设置 NEXUSMC_PAT):

curl --fail-with-body 'http://127.0.0.1:4520/v1/personal/posts' \
  --header "Authorization: Bearer $NEXUSMC_PAT" \
  --header 'Content-Type: application/json' \
  --data '{"title":"Fabric 性能配置交流","body":"分享配置与测试结果。"}'

请求成功会返回 { "ok": true, "id": "新帖子的稳定 ID" }。这会实际创建内容,请使用自己的测试环境。