接口令牌

创建、使用与撤销开放接口的访问令牌（读与写权限）。

什么是接口令牌

接口令牌是给第三方网站或你自己的脚本用的访问凭据，可以访问 X2Post 的开放接口（/api/open/v1）。入口在「资料设置 → 接口令牌」。

令牌只代表你本人的数据，不会让对方拿到你的密码。默认只读：只有你勾选了写权限（发布帖子/评论等），对方才能以你的身份发布内容。

进入「资料设置 → 接口令牌」，点「创建令牌」；
填写名称（只用于自己辨认用途），勾选需要的权限：
- 读：公开资料、你发布的帖子列表、社区公开内容（帖子、评论、版块与标签、任意用户的公开资料与动态）——在 AI 客户端里用社区数据时需要「读取社区公开内容」；
- 写（按需勾选）：发布帖子、发表/删除评论与回复、关注与取关、点赞与收藏；
选择有效期（30 天 / 90 天 / 1 年 / 长期有效）；
创建后明文只显示一次，请立刻复制保存。

写权限意味着对方能以你的身份发布内容（帖子发布后不可编辑、不可删除，与站内一致）。不确定要不要给时，只勾读权限即可。

调用时把令牌放在请求头里：

curl -H "Authorization: Bearer <你的令牌>" https://x2post.com/api/open/v1/me

同一个令牌也能让 Claude、Cursor 这类 AI 客户端读社区内容（搜索帖子、读帖子与评论、版块标签、公开资料）。完整步骤（含推荐的一键授权方式，不必手工创建令牌）见《用 AI 客户端读社区》；这里只列用令牌的方式：

{
  "mcpServers": {
    "x2post": {
      "url": "https://x2post.com/mcp",
      "headers": { "Authorization": "Bearer <你的令牌>" }
    }
  }
}

两点提醒：

能读到什么由令牌权限决定：完全等于你勾选的那些 scope，随时可以在令牌页撤销；
内容会进入你所用模型的上下文：工具返回的社区内容会发送给你配置的那个 AI 服务商（Anthropic、OpenAI 等），请自行判断是否可接受；帖子里作者标注为「回复可见」的加密内容不会被返回。

每个令牌每分钟最多 60 次请求，超出会返回 429（响应头带 Retry-After）；在 AI 客户端里，一次「读帖子」通常消耗 1 次额度；
写接口另有与站内同口径的频次限制（发帖 5 次/分、评论 10 次/分等），并与你在站内的操作共用额度；
读写接口一览：
- 你的数据：/api/open/v1/me（公开资料）、/api/open/v1/me/posts（你的帖子列表）；
- 社区公开内容：/api/open/v1/posts（搜索/浏览）、/api/open/v1/posts/{id}（详情）、/api/open/v1/posts/{id}/supplements（补充说明）、/api/open/v1/posts/{id}/comments（评论）、/api/open/v1/comments/{id}/replies（回复）、/api/open/v1/categories（版块与标签）、/api/open/v1/users/{username} 系列（资料、帖子、评论、点赞/收藏、粉丝/关注）；
- 写接口：发帖 /api/open/v1/posts；评论 /api/open/v1/posts/{id}/comments、回复 /api/open/v1/comments/{id}/replies、删除自己的评论 DELETE /api/open/v1/comments/{id}；关注 POST/DELETE /api/open/v1/users/{username}/follow；点赞/收藏 POST/DELETE /api/open/v1/posts/{id}/like、/comments/{id}/like、/posts/{id}/favorite；
写接口的正文不支持站内拓展块（投票、加密文本、引用等，会返回 422）；发帖/评论/回复支持 Idempotency-Key 请求头，重试不会重复发布；
令牌无效、过期或被撤销时返回 401；权限不足返回 403。