抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

消息推送配置接入

收藏
我的收藏

消息推送说明

消息推送是用户事件触发反向通知的机制,开发者可根据需要订阅事件,接收通知。
用户在抖音生活服务内的数据变更时,可通过SPI/webhook 的方式将消息推送给开发者,开发者可以根据需要订阅不同消息。消息仅包含基本的信息,如需要查询详细数据,可在收到消息后主动调用相关接口获取明细数据。

SPI

SPI是抖音侧制定接口规范,外部服务商/开发者按规范实现HTTP接口,由抖音侧发起调用,传送数据,并对开发者的响应数据进行处理(包括HTTP状态码、响应体内容)的机制。常用于接收平台主动推送的事件通知、业务状态变更等回调,需配置https回调地址,支持两种签名校验方式(推荐Header签名)。

WebHooks

Webhooks是抖音侧制定接口规范,外部服务商/开发者按规范实现HTTP接口,由抖音侧发起调用,传送数据,仅处理开发者响应的HTTP状态码(不对响应体内容处理)的机制。配置需完成回调地址验证(接收verify_webhook请求,返回含challenge的JSON)、订阅事件;若长时间未响应推送结果,订阅状态可能取消需重新订阅。消息可通过X-Douyin-Signature验证来源。

如何选择

抖音侧在事件通知的方案选择上,会根据业务场景进行决策,通常来说:
    WebHook不保证时效性、时序性、必达
    要求开发者必须收到消息并处理的场景使用SPI
对于开发者:在接入某解决方案时,参考具体解决方案,按照解决方案中提供的具体事件的通知方案接入既可,若抖音侧提供的推送接口是SPI,就选择SPI方式,若为WebHooks,就选择WebHooks方式。