如何配置 Webhook？

1. 什么是 Webhook？

Webhook 是一种服务器间的回调机制，当特定事件发生时，FacePick 会向您配置的 HTTPS 地址发送 POST 请求，通知您相关的事件数据。

请确保您的服务地址可以正常访问，并能在 5 秒内返回 200 状态码。本页的配置表单是本地演示：校验通过后只保存在本机会话，不会向您填写的地址发送任何请求，不探测内网、不接入真实 Webhook 后台。

2. 配置 Webhook

在控制台的「应用管理」>「回调设置」中，填写你的 Webhook 地址，并选择需要订阅的事件类型。下方嵌入的是同款本地演示表单：

3. 请求示例

下方示例会随「2. 配置 Webhook」中表单的事件选择实时联动（未选择事件时展示默认的「订单完成」示例；示例结构，不会真实推送）：

{
  "event": "order.completed",
  "order_id": "FP202508200081",
  "status": "success",
  "timestamp": "2025-08-20T10:24:36Z",
  "data": { "face_id": "face_demo_123", "type": "image", "url": "https://api.demo.invalid/demo.png" }
}

收到回调后的处理（验签、幂等、过期事件）见「如何处理数据回调」文章：两页共用同一份事件数据，事件名称与示例字段明确对应。