用途:为 Apify Actor 运行配置 Webhook,实现运行完成、失败、超时等事件的通知与事件驱动管道,是生产环境 Apify 集成的推荐模式。
主要能力:支持持久化 Webhook(对某 Actor 的所有运行生效)与 ad-hoc Webhook(仅对单次运行生效)。事件类型包括 ACTOR.RUN.CREATED、SUCCEEDED、FAILED、ABORTED、TIMED_OUT、RESURRECTED。可通过 payloadTemplate 自定义投递的 JSON 内容,并用 client.webhook(id).dispatches().list() 查看投递历史与响应状态。
使用方式:先安装依赖 npm install apify-client(如需 HTTP 处理再加 express),从环境变量读取 APIFY_TOKEN,切勿硬编码;准备公开 HTTPS 端点(开发时可用 ngrok)。持久化 Webhook 通过 client.webhooks().create 设置 eventTypes、condition.actorId、requestUrl 与 payloadTemplate;ad-hoc 则在启动 Actor 时传入 webhooks 数组。处理端点须在 30 秒内返回 2xx,建议先确认接收再异步处理;SUCCEEDED 时用 defaultDatasetId 拉取数据集,FAILED/TIMED_OUT 时查看运行日志并告警。
限制与注意:Apify 可能重复投递,需按 ${actorRunId}:${eventType} 去重实现幂等;处理超时、URL 不可达、模板变量拼写错误、失败过多导致 Webhook 被禁用等均需处理。资料未提供具体收费与价格信息。