Buffer旧版API将于2027年停用，速迁移
今年五月，我们正式发布了Buffer的GraphQL公共API，让开发者能够基于Buffer进行构建。这是一套强类型、以GraphQL为核心的API，配备了MCP服务器、命令行工具和托管式OAuth，运行在与我们自有应用相同的基础设施之上。随着新API的上线，我们正在逐步淘汰它所替代的旧版API。
我们计划于2027年2月1日停用Buffer的旧版REST API。在此日期之后，向旧版端点发出的请求将不再返回数据；因此，所有仍在使用旧版REST API的客户端应尽快启动迁移流程。
REST API的由来
我们最早在2012年推出了Buffer的公共API，当时与大约15个集成合作，包括Pocket、IFTTT等早期热门网络应用。它基于当时标准的REST架构构建，允许开发者安排帖子发布和管理个人资料。到2019年，已有超过47,000个客户端在此基础上进行开发。
随后，行业环境发生了变化。在剑桥分析等隐私丑闻之后，社交平台收紧了服务条款和数据隐私要求。因此，我们希望确保用户数据的安全，并限制API的使用方式。几乎同时，我们自身的架构也在演进：我们将曾经独立的产品统一为“一个登录，全Buffer”，并开始将所有功能整合到一个现代化的单一GraphQL API上。2019年10月，我们关闭了旧版应用的注册——我们意识到，没有更大的投入，就无法提供我们（以及合作伙伴）所期望的开发者体验。
这一投入最终催生了Buffer的GraphQL公共API。与其维护两套拥有不同工具集的API栈——这对我们这样规模的团队来说负担沉重——我们决定全力打造一个既支持我们自有应用也支持你们应用的统一API。停用旧版REST API正是这一过渡的最后一步。
变化内容
旧版REST API将于2027年2月1日完全停用。向旧版端点的请求将不再返回数据。
这会影响所有仍在调用旧版REST API端点的用户。
旧版API上创建新客户端的通道已经关闭。
旧版端点将添加弃用和停用信号：标准的弃用和停用HTTP头部，以及指向迁移指南的链接头部。
在正式停用前，计划进行两次短暂中断测试：2026年11月11日和12月9日。届时，旧版请求将暂时返回错误。所有尚未完成迁移的旧版客户端将提前收到关于这些测试的通知。
如何迁移至新API
我们已完成新旧API之间功能的全面对比分析，几乎所有旧版功能都在GraphQL API中有直接对应项。
熟悉的概念只是换了新名称——个人资料变成了频道，更新变成了帖子。在GraphQL下，一些操作方式也有所不同，迁移前值得了解：
- 调度是按帖子进行的。无需管理个人资料上的重复时间段，你可以决定每个帖子的调度方式：加入队列、设置特定时间或立即发布。
- 帖子是逐个频道创建的。旧版API接受一个个人资料ID数组，而现在你需要为每个频道发送一个请求。
- 分页采用基于游标的方式，而非页码加偏移量，因此即使队列发生变化，分页也能保持可靠。
- 错误以响应体中的类型化字段返回，而非HTTP状态码。
如需完整的端点映射和代码示例，请参阅REST API迁移指南。如果你在迁移中遇到阻碍，请联系Buffer团队——我们愿意提供帮助，确保迁移顺利进行。
如需迁移帮助
如果你维护的是旧版集成且需要迁移帮助，请通过Discord联系我们，或发送邮件至[email protected]——我们可以协助你完成迁移，或解决你遇到的障碍。如果你依赖的功能没有对应项，请告知我们，我们将与你一起寻找解决方案。
