| 内容类型 | 支持情况 | 说明 |
|---|---|---|
| 图文 | 已支持 | article 类型,结构化正文随签名一起推送 |
| 视频 | 已支持 | video 类型,含地址与规格信息 |
| 图集 | 已支持 | images 类型,图片数组一次给全 |
| 音频 | 已支持 | audio 类型,四种形态在这里都是通的 |
在你的系统里放一个 POST 端点,能接 JSON,并在成功时返回 HTTP 200。这是唯一的必要条件。
创建账号池时选「自定义平台」,填 notice_url 和一个自己定的签名密钥,两项缺一项不会发起推送。
按内容类型带上随机串做一次哈希签名,和结构化数据一起 POST 过来。
验签、入库、排版、上线都由你控制。云梭负责生产内容和送达,不替你决定怎么展示。
其余 14 个平台的发布动作,本质上是系统在别人的网页里替你操作。这带来一个绕不过去的事实:平台一改版,链路就可能断,需要有人立刻去修。云梭发布一直在做这件事,但风险结构决定了它永远存在。
自定义站点通道不是这样。它不启动浏览器、不定位任何选择器,只做一次带签名的 HTTP 推送,接收端是你自己的代码。平台改版、页面重构、组件加壳都影响不到它。四种内容形态(图文、视频、图集、音频)在这个通道上都是通的,没有哪个平台的「本产品不提供该形态」限制。
适合的场景很具体:自有 CMS 想持续喂内容、站群或独立站需要成批更新、内容要先过自己内部审核再择时上线、以及某个平台还没被接入但你现在就要发。
推送包体是四个字段:type(内容类型)、signature(签名)、nonce(随机串)、data(结构化内容)。签名算法是:
signature = sha512( signature_key + "&data_type=" + type + "&nonce=" + nonce )
用你创建账号池时自己填的那把密钥参与计算,十六进制小写输出。你的接收端把同样的字符串算一遍比对即可,nonce 每次随机,所以重放的请求签名对不上。
成功判定只有一条:你的接口返回 HTTP 200。云梭不解析你的响应体——这样你的系统可以用任何返回结构,只要状态码说明收到了。业务层的失败请返回非 200,那一次推送会被记为失败。
如果你的内容本身没带封面图,系统在推送前会按标题自动绘制一张封面,再上传到云梭的资源节点,把这个可访问的地址一起放进包体。这样你的接收端拿到的永远是一个能直接展示的结构,不用自己处理缺图。
需要提醒的是配置完整性:接收地址与签名密钥都存放在账号池里,任何一项缺失都会被当作无法发布处理,而不是带着残缺配置去推。这一类错误的表现是任务直接失败并写明原因,而不是发出去但签名验不过。
下面这些是客服和工单里出现频率最高的几问