Webhook

任务进入终态（SUCCESS / FAILED）时，平台向回调地址 POST JSON。

配置

1. 开放平台 → API keys → 配置默认 Webhook URL / Secret
2. 或创建 / 流式时传查询参数 ?callbackUrl=

请求级 callbackUrl 优先于 Key 默认回调。

回调 Body 字段

字段	类型	说明
event	string	如 valuation.success / valuation.failed
taskId	number	任务 ID
valuationNo	string	估值编号
assetType	string	PROPERTY / VEHICLE / LAND / EQUIPMENT / BANK_STATEMENT
status	string	SUCCESS / FAILED
result	object | null	成功时的估值结果，结构见各资产页
errorMessage	string | null	失败原因
occurredAt	string	ISO 时间

{
  "event": "valuation.success",
  "taskId": 123,
  "valuationNo": "VAL-EQP-20260818-0001",
  "assetType": "EQUIPMENT",
  "status": "SUCCESS",
  "result": {
    "estimatedResidualValue": 680000,
    "confidence": 0.72
  },
  "errorMessage": null,
  "occurredAt": "2026-08-18T09:05:00Z"
}

验签

若配置了 Secret：

X-AssetAI-Signature: sha256=<HMAC_SHA256_hex(secret, rawBody)>

请对原始 body 字节验签，业务处理成功后返回 2xx。