Postproxy

Postproxy 是什么？

Postproxy 是一个统一的社交媒体发布 API，使用单个 REST 端点即可发布到多个社交网络。无需构建和维护各平台的独立集成，只需连接一次并发送一个负载；Postproxy 会将您的内容和媒体映射到每个所选平台的规则。

核心目的是提供稳定的发布 API 层，包括连接处理、请求到平台的转换，以及各平台的发布结果。

主要特性

• 统一发布端点 (REST)：发送单个请求（例如 POST /v1/publish 或文档中的 POST /api/posts），包含一个负载和选定的“profiles”，Postproxy 将处理跨多个平台的发布。
• 各平台结果映射：API 返回每个目标 profile 的结果（例如已发布、处理中、失败），让您了解每个网络的情况。
• 平台连接管理：OAuth 流程、令牌存储和自动刷新均由 Postproxy 在平台连接流程中为您处理。
• 确定性重试和状态报告：系统支持重试和限速/配额感知行为，提供清晰的发布状态报告和日志记录的尝试。
• 格式转换以适配信达：内容会被转换为满足每个平台的要求（例如消息/正文如何为每个网络适配）。
• 常见语言 SDK：官方 SDK 支持 Node、Python、Ruby 等流行语言，减少自定义 API 集成工作。
• 发布生命周期事件的 Webhooks：您可以创建 webhook 端点（例如事件 post.processed、platform_post.published 和 platform_post.failed），接收 Postproxy 的更新。

如何使用 Postproxy

1. 从 Postproxy 文档开始，使用您的 API 密钥创建 API 请求（站点显示 Authorization: Bearer YOUR_API_KEY 和 JSON 负载示例）。
2. 通过 Postproxy 的平台连接 (OAuth) 连接您想发布的社交账户。Postproxy 管理令牌和刷新。
3. 通过发送帖子内容加上目标 profiles（平台）列表和可选媒体 URL，使用一个请求进行发布。
4. 可选：订阅 webhook 事件，以便您的应用在处理完成或平台发布成功/失败时收到通知。

站点示例负载包括字段如：

• post.body（或某些 SDK 示例中的 content）
• profiles（例如 "twitter"、"linkedin"、"threads"）
• media（媒体 URL 数组）

使用场景

• 在您的应用中构建单一“发布”操作：产品可为用户提供一个发布流程，而 Postproxy 处理每个所选平台的格式化、投递和结果。
• 替换脆弱的各平台集成：团队可将多个自定义集成整合为一个 API 调用，减少受平台特定变更影响的范围。
• 代理或多客户发布队列：使用 profile 分组和调度/队列概念，隔离不同客户的连接，并管理高容量发布。
• 自动化管道和 AI 触发发布：将发布视为上游工作流中的单一步骤（例如由自动化节点或代理触发），Postproxy 处理重试和状态。
• 无 Postproxy 账户的终端用户服务器端发布：为每个客户提供范围限定环境，让发布在您的品牌下运行，用户通过您的 UI 连接账户。

常见问题

• 支持哪些平台？ 站点列出了对 Instagram、TikTok、LinkedIn、X、YouTube、Facebook、Threads 和 Pinterest 的支持。

• 可以用一个请求发布到多个网络吗？ 可以。示例显示单个负载中 profiles 指定目标平台，API 将内容映射到每个平台。

• 我需要自己处理 OAuth 令牌刷新吗？ 不需要。站点说明 OAuth 流程、令牌存储和自动刷新由系统为您管理。

• 如何知道每个平台是否成功？ Postproxy 提供各平台结果（包括失败和已发布状态），并支持确定性重试和明确状态报告。

• 发布事件有 Webhooks 吗？ 有。站点包含 webhook 创建请求示例，事件如 post.processed、platform_post.published 和 platform_post.failed。

替代方案

• 直接构建与官方平台 API 的集成：这可提供最大控制权，但通常需要为每个平台维护独立的 OAuth 流程、格式规则、限流处理以及错误/重试逻辑。
• 使用专用的社交媒体管理平台：这些工具通过自身工作流处理跨网络发布；您需以牺牲自定义 API 控制为代价，换取更快的设置和固定的 UI/流程。
• 使用通用自动化 + 调度器搭配各平台适配器：您可以在管道中编排发布步骤，但仍需为每个目标网络编写适配器/集成代码。
• 使用带有社交连接器的 iPaaS/集成服务：这可集中化工作流，但消息转换、重试策略和各平台结果细节取决于可用连接器和配置。