创建社交帖子

为一个品牌创建一篇帖子，发布到该品牌已连接的一个或多个社交账号。一次调用即可涵盖全部 3 种生命周期：保存 DRAFT、将 SCHEDULE 加入队列，或立即 PUBLISH。

使用场景：通过您自己的日历安排营销活动。您的应用已经知道客户想发布什么内容，以及何时发布。对于每个时段，调用此端点时传入 action: "SCHEDULE"，并传入 scheduledAt 或 scheduleDate + scheduleTime，同时将您自己的时段标识符作为 clientReference 传入，这样无需存储返回的 UUID 也能核对。在 GET /social/posts/{postId} 报告所有渠道均已发布之前，将该条目显示为待处理，并提供一个调用 POST /social/posts/cancel 的取消按钮。

发布是异步的

action: "PUBLISH" 在返回响应之前不会发布帖子。此调用会接受帖子，返回 socialPostId，并将帖子交给发布流水线。要了解实际结果，请轮询 GET /social/posts/{postId} 并读取按渠道列出的 channels[] 数组：每个条目的 status 表示对应平台的结果。同一个请求中的帖子可能在 Instagram 上发布成功，却在 LinkedIn 上发布失败，因此应以 channels[] 为准，而帖子级别的 status 只是摘要。

选择定时发布方式

action: "SCHEDULE" 要求使用以下 2 种形式之一，不能同时使用：

同时发送这 2 种形式、发送 scheduleDate 却不发送 scheduleTime，或发送不带时区偏移量的 scheduledAt，都会被拒绝并返回 SY95046。DRAFT 和 PUBLISH 均不得携带任何定时发布设置。

注意事项。

• 请求体必须封装在 input 对象中。
• 检查 success，而不是 HTTP 状态。验证失败时会返回 HTTP 200，其中包含 success: false，且 error 数组中的每个条目对应一个问题。当 success 为 false 时，不会创建任何内容。
• 请求体通过 socialProfileId 标识品牌。brandId 只用作 URL 路径参数，从不用作请求体字段。
• platforms 中的每个平台都必须已在该品牌下建立连接。如果某个平台没有有效渠道，则会失败并返回 SY95045；请先读取品牌的连接，对于缺少连接的平台，引导用户通过连接链接 建立连接。
• 平台值为大写枚举名称 FACEBOOK、INSTAGRAM、TWITTER、LINKEDIN、PINTEREST。TWITTER 表示 X；该值保留了旧名称，小写值会被拒绝。
• Instagram 和 Pinterest 不接受纯文本帖子：当 platforms 包含其中任一平台时，请提供至少 1 个 mediaUrls 条目。
• 帖子 ID 是普通 UUID，而不是地点帖子使用的 Base64 relay ID。
• 如果要一次处理较多帖子，请使用 POST /social/bulk-posts，它接受相同的行结构，并会预先验证整个批次。

写入操作：未在实际账户中执行。所示请求和响应根据 API schema 构建；实际运行时，会向真实社交账号发布内容。