事件 · 核实
verification.requested
已请求核实
已请核实人复核卡片:有人请求了复核,或指派了新的核实人(data.reason: requested | new_verifier)。
- 对象类型
- card
- 投递对象
- 能看到该对象的 Webhook:按角色、数据权限档案和合集确定
有效负载
idstring必填事件 ID(
evt_…),也会作为webhook-id头发送。可用于丢弃重复的投递。typestring必填可选值:
verification.requestedcreated_atstring (date-time)必填变更发生的时间(UTC)。
org_idinteger必填api_versionstring必填data结构定义的契约版本。sequenceinteger在该 Webhook 内的投递序号(测试事件不返回)。
payloadstring必填thin表示没有data:请通过 API 读取对象。可选值:
fullthindataobject字段
actor_idinteger | null必填执行该操作的用户;由组织 API 密钥或平台自身执行时为
null。reasonstring必填中性原因代码(可扩展枚举:将未知代码视为一般性失败)。取值:
requested、new_verifier。notestring
testboolean必填由
POST /v1/webhooks/{webhook_id}/test发送的测试事件。
投递示例
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "verification.requested",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "card",
"id": "c_9f2e41"
},
"payload": "full",
"data": {
"card": {
"id": "c_9f2e41",
"title": "Refund policy",
"collection": "support",
"collection_id": 3,
"version": 4,
"kind": "text",
"status": "ready",
"verification_state": "needs_verification",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"actor_id": 11,
"reason": "requested",
"note": "Prices changed in October"
},
"test": false
}接收事件
每次投递都是向 Webhook 接收地址发送的 POST 请求,请求体就是这个 JSON。先验证 webhook-signature 头(Standard Webhooks),再信任请求体;在几秒内返回 2xx 状态,之后再处理。投递到同一个 Webhook 的事件保持原有顺序;投递失败时按逐渐拉长的间隔重试。
随时可能新增事件类型和字段:跳过不认识的类型和字段。