🛠️ Webhook 配置说明
Webhook 是用于接收外部事件通知的重要功能,以下是配置步骤:

  1. 启用 Webhook
    在系统设置中开启 Webhook 功能,确保服务端支持 HTTPS 协议。
    ⚠️ 注意:请务必配置有效的 SSL 证书以保障数据安全

  2. 设置回调地址
    输入您希望接收通知的 URL,格式应为:https://yourdomain.com/webhook_endpoint
    📡 示例:https://api.example.com/v1/hooks/12345

  3. 验证签名
    系统将通过 POST 请求发送验证包,需在您的服务端校验 X-API-Signature 头部
    ✅ 验证通过后,Webhook 会进入活跃状态

  4. 测试触发
    通过 /webhook/test 接口手动触发事件,观察日志输出
    📝 测试结果可查看:Webhook 事件日志

📌 安全建议

  • 使用 POST 方法接收数据
  • 配置 IP 白名单(如:/settings/security
  • 定期轮换密钥(参考:密钥管理文档
webhook_configuration
如需进一步了解 Webhook 协议细节,请访问 [Webhook 技术规范](/webhook_protocol) 了解更多。