跳转到内容

X 开发者准备

  1. 打开 X 开发者后台
  2. 注册一个免费账号即可 —— Postiz 官方文档的接入流程就是按免费层级写的

创建一个新应用,然后打开它的设置进行编辑。三项设置必须按下表填:

设置项 必须填的值 填错的后果
App Permission(应用权限) Read and Write 只有 Read 会发不出帖
Type of App(应用类型) Native App 见下方警告
Callback URI / Redirect URL 见下表 授权回调失败

按 Postiz 的部署方式选一个:

部署方式 回调地址
生产(有域名) https://你的postiz域名/integrations/social/x
本地开发 http://localhost:4200/integrations/social/x
Docker http://localhost:5000/integrations/social/x
本地但平台强制 HTTPS https://redirectmeto.com/http://localhost:4200/integrations/social/x
  1. 保存设置后,打开应用的 「Keys and Tokens」 标签页
  2. 在 Consumer Keys 区域点 「Regenerate」
  3. 复制 API Key 和 API Key Secret(只显示一次,当场存好)
  4. 写进 Postiz 环境变量:
X_API_KEY=""
X_API_SECRET=""

可选变量:

变量 作用
X_URL 指向自建的 X 兼容 API
DISABLE_X_ANALYTICS=true 关掉 X 数据分析请求(计划无该权限时用,消除日志噪音)
STRIP_LINKS_FROM_X_POSTS=true 发布前全局剥掉文案里的链接

X 账号的长文能力(本系统特有)

Section titled “X 账号的长文能力(本系统特有)”

X 免费账号单帖 280 加权字符,订阅账号(Premium)可到 4000。系统会自动探测,不需要手填:

  • 首次发布一条超过 280 加权字符的内容,发布成功 → 判定为订阅账号(4000)
  • 被平台以长度为由拒绝 → 判定为免费账号(280)
  • 也可以在「账号健康」页手动填「文本上限」覆盖探测结果;清空则重新探测

详见 账号与路由 · 编辑台账。

现象 原因 怎么修
授权报 错误码 32 Type of App 选错了 改成 Native App
授权回调 404 / 地址不匹配 回调地址与 Postiz 域名不一致 逐字符核对,注意 http/https
能授权但发帖 403 App Permission 只有 Read 改成 Read and Write,改完重新授权一次
长文被拒 账号是免费层级 属正常;系统会自动记为 280 上限
日志刷数据分析失败 账号计划无分析权限 设 DISABLE_X_ANALYTICS=true