网络回调 (WebHooks)

Webhook 是什么？

任务完成时自动发送通知到指定 URL 的功能。

使用场景

任务完成时触发其他系统
发送 Slack 通知
更新数据库
触发数据处理流程
发送电子邮件

设置 Webhook

访问 [设置] → [Webhook]

输入 Webhook URL

选择触发事件

任务完成
任务失败
任务开始

测试并保存

Payload 格式

Listly 发送的 POST 请求：

{
  "event": "task.completed",
  "task_id": "abc123",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:35:00Z",
  "urls_processed": 50,
  "urls_failed": 2,
  "data_url": "https://api.listly.io/v1/tasks/abc123/data"
}

Slack 集成

方法 1：使用 Slack Webhook

在 Slack 创建 Incoming Webhook

在 Listly 输入 Webhook URL

自定义消息格式

方法 2：使用中间服务

使用 Zapier 或 Make (Integromat) 连接 Listly 和 Slack。

示例：接收 Webhook

server.js

app.post('/webhook', (req, res) => {
  const { event, task_id, status } = req.body;
  
  if (event === 'task.completed') {
    console.log(`任务 ${task_id} 已完成`);
    // 处理完成事件
  }
  
  res.sendStatus(200);
});

app.py

from flask import Flask, request

@app.route('/webhook', methods=['POST'])
def webhook():
    data = request.json
    
    if data['event'] == 'task.completed':
        print(f"任务 {data['task_id']} 已完成")
        # 处理完成事件
    
    return '', 200

安全性

验证签名

Listly 在请求头包含签名：

X-Listly-Signature: sha256=...

验证签名确保请求来自 Listly。

import hmac
import hashlib

def verify_signature(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

重试机制

失败时自动重试 3 次
重试间隔：1分钟、5分钟、15分钟
返回 2xx 状态码表示成功