接入指南

概述

当事件(Event)发生时，开放平台会通过https post的方式将事件推送到开发者配置好的回调地址。通过Webhooks机制可以方便开发者第一时间获取到关注的事件变化。

回调地址校验

在管理中心 Webhooks页填写你要配置的请求网址。完成请求网址编辑后，点击保存按钮时，开放平台会向你配置的网址推送一个 POST 请求, 该请求用于验证你配置的网址的合法性。需要用户按照协议返回对应的信息,来通过验证,协议见测试事件

重试机制

服务端发送webhook消息失败后,会尝试重试3次,每次间隔5秒,开发者需要基于taskId做好幂等

消息来源验证

用户可通过请求header中的 kwaisign 字段来判断消息的可靠性。 快手服务端会将应用的md5(原始消息体+appecret)的方式进行签名,开发者需要对签名的合法性进行验证。