颜小二能不能同时支持多平台发布？一篇讲清楚机制与字段
简短答案：可以。颜小二自媒体发布 API 平台一次 HTTP 调用就能把同一篇文章下发到头条号、微信公众号、百家号、知乎等多个平台，每个平台返回独立的回调结果。
这是被问得最多的一个问题，但很多团队问的其实不是"支不支持"，而是"它是怎么做到的，会不会发一半挂一半，多账号怎么并发"。下面把这件事拆开讲。
背景与机制
颜小二的定位是"多租户内容分发执行中台"。所谓"中台"，意思是你的业务系统只面向一个统一文章接收 API，平台差异、登录态、并发、重试这些事都在中台里解决。
多平台同时发布的工作流程大致是这样：
1. 你调用统一文章接收 API，请求体里通过 target_platforms 列出本次要分发的目标平台 2. 颜小二根据请求里的 group_code 命中目标账号集合（这一组里包含每个平台对应的账号） 3. 任务被拆分成"每平台一条子任务"下发到本地 Agent，并行执行 4. 每个子任务完成后单独通过 callback_url 回调，回调里带 platform、platform_url、status 等字段 5. 你的系统按 external_id + platform 入库，全部收齐后认为这次"分发"完成
整个过程是异步并行的：四个平台不是排队发的，而是同一时刻并发跑。某个平台慢一点不会卡住别的。
相关字段
| 字段 | 作用 | 备注 | |---|---|---| | external_id | 你侧的业务唯一 ID | 用来做 external_id 幂等去重 | | group_code | 账号分组路由键 | 一个 group 对应多平台多账号 | | target_platforms | 本次分发的目标平台数组 | 不传则按 group 默认全发 | | content_html | 正文 HTML | 各平台会按规则做轻度适配 | | tags / category | 标签与分类 | 平台支持差异由中台屏蔽 |
回调里关键字段：
| 回调字段 | 含义 | |---|---| | platform | 哪个平台的结果 | | status | success / failed / login_expired | | platform_url | 成功时的文章详情页 | | error_msg | 失败时的结构化原因 | | external_id | 回填你的业务 ID |
注意事项
第一，"同时支持多平台"不等于"每个平台行为完全一致"。各家平台的字数、标签数量、正文标签白名单都不一样，颜小二会做一层适配，但极端情况下（比如正文里塞了平台不支持的标签）某个平台会单独失败，不会影响其他平台。
第二，external_id 幂等是按 external_id + platform 维度生效的。同一篇文章用同一个 external_id 重发，每个平台只会有一条结果，不用担心重复发。
第三，登录态本地保存。每个账号的 cookie 都在客户侧本地 Agent 里，颜小二云端只调度任务，不存任何登录凭证。这点对账号资产合规很关键。
第四，回调按子任务粒度走，不是一个平台失败就整体失败。如果四个平台里有一个登录态过期，回调里只有那一条带 login_expired，其他三条照常 success。
相关问题
- 能不能只发其中两个平台？ 可以，
target_platforms字段按需指定。 - 怎么知道有没有发完？ 收齐
target_platforms个数的回调即视为完成；或在你侧维护一个超时阈值（建议 ≥10 分钟）。 - 多平台发布会被风控集中识别吗？ 不会。每个账号独立浏览器 context、独立指纹、登录态本地保存，详见 [产品功能](/product.html) 与 [callback 工作机制](/lp/faq-how-callback-works.html)。
常见问题（FAQ）
Q：未来新增一个平台需要我改业务代码吗？ 不需要。在 group_code 下加一个新平台账号、把平台名加进 target_platforms 即可。颜小二底层适配新平台，业务代码不动。
Q：多平台分发是不是要付多份费用？ 按计费模型走，详见 [价格页](/pricing.html)。同一次调用产生 N 个平台子任务时按子任务计。
Q：回调要一个端点还是多个？ 一个就够。颜小二每个租户固定一个 callback_url，所有平台、所有账号的结果都打到这一个端点上，靠 external_id + platform 路由到你内部业务。
Q：如果某个平台那段时间审核很慢，会一直挂着吗？ 不会。每个子任务有最大时长，超时会以 failed + timeout 上报，由你决定后续重发还是放弃。
Q：颜小二支持私有部署吗？ SaaS + 本地 Agent 的混合部署是默认架构，登录态全部留在客户侧；纯私有部署看具体规模与合规要求，可以在 [联系我们](/contact.html#form) 沟通。
下一步
如果你正在评估"一个 API 同时发多平台"是不是符合你的工作流，最快的验证方式是接一次最小可行链路：1 个 group、2 个平台、1 篇测试稿。
→ [免费申请接入](/contact.html#form) | [API 文档](/docs.html) | [更多常见问题](/faq.html)