用途:面向 Buffer 社交媒体排期平台,用于跨渠道创建、排期、修改、查询和删除社交帖子,并管理已连接频道。
主要能力:列出组织与频道(支持 Twitter、LinkedIn、Instagram、Facebook、TikTok、Threads、Mastodon、Bluesky、Pinterest、YouTube、Google Business);创建帖子(draft、scheduled、needsApproval);支持图片或视频媒体附件;查询待发/已发/草稿/待审批帖子并分页;更新与删除帖子;将同一条文本交叉发布到多个频道。
使用方式:API 为 beta 阶段的 GraphQL,单一端点 POST https://api.buffer.com,所有请求为 JSON {"query":...,"variables":...} 格式,需携带 Authorization: Bearer $BUFFER_TOKEN 与 Content-Type: application/json,缺少有效密钥返回 401。个人 API 密钥来自开发者面板,仅组织所有者可创建(付费账户最多 5 个,免费账户 1 个)。
限制与注意:分析数据尚未在 beta API 暴露,帖子级统计需用网页仪表盘;已发送(sent)的帖子不能再用 updatePost 修改;旧版 REST API api.bufferapp.com/1/* 不接受新开发者申请且需 OAuth,本连接器不使用;速率限制按客户端滚动计算,个人密钥共享同一配额,多集成应各建独立密钥;组织 ID 稳定建议缓存。
故障排查:可运行 zero doctor check-connector --env-name BUFFER_TOKEN 或 zero doctor check-connector --url https://api.buffer.com --method POST 检查连接。完整示例、字段与代码请以官方资料为准,此处未逐一展开。