开发者指南
已上线
Professional 方案
事件发生的瞬间就通知到
员工打卡或请假被批准后,您的后端会在数秒内收到 POST——无需轮询,无需定时任务。带签名的投递、自动重试、Endpoint 故障时还有 dead-letter 队列。
可以做什么
上线即见效。中小企业管理员无需研发即可配置。
实时推送，无需轮询
员工打卡、请假审批、流程状态变更——您的后端在数秒内收到 POST。无需每 5 分钟轮询 API（更便宜也更快）。
防篡改投递
每条请求都带 X-SVDY-Signature: sha256=… 头部，使用您的密钥对 JSON body 计算 HMAC。在端点校验签名即可冷拒绝伪造请求。
重试 + 死信队列
非 2xx 响应会在 1m/5m/30m/2h/12h 重试。5 次失败后投递进入死信队列，可在 /system/integrations/webhooks 查看。端点临时故障时不会丢事件。
4 步完成配置
预计耗时：管理员准备好凭据后 5 分钟内即可完成。
1
在组织管理后台创建 webhook
集成 → Webhooks → 添加 Webhook。填写端点 URL + 选择关心的事件。SVDY 仅显示一次签名密钥——立刻保存。
2
构建接收端
您的端点接受 POST application/json。处理前校验 HMAC 签名。10 秒内返回 200（否则 SVDY 视为失败并重试）。
# Python receiver — Flask sketch
import hmac, hashlib, json
from flask import request, abort
SVDY_SECRET = b"<paste-from-svdy-admin>"
@app.post("/webhooks/svdy")
def receive():
sig = request.headers.get("X-SVDY-Signature", "")
expected = "sha256=" + hmac.new(
SVDY_SECRET, request.data, hashlib.sha256
).hexdigest()
if not hmac.compare_digest(sig, expected):
abort(401)
event = json.loads(request.data)
# ... handle event["type"], event["data"]
return "", 2003
用「发送测试事件」按钮试一下
在 webhook 详情面板——会向您的端点发一个合成事件。响应码和 body 立刻显示在投递日志中。
4
重发失败投递
每条投递在活动面板显示状态（已投递 / 重试中 / 已死信）。修复端点后，点「重发」即可重新触发死信投递。