约定与通用响应

开放估值接口统一走 /api/open/v1，使用 API Key 鉴权。五类资产（房产 / 车辆 / 土地 / 设备 / 银行流水）创建、查询、流式的路径同构，请求体字段按资产类型不同，见各资产页。

调用方式

方式	接口	适用
轮询	POST /{asset}-valuations → GET /{asset}-valuations/{taskId}	批处理、长任务
流式	POST /{asset}-valuations/stream（SSE）	前端实时展示思考过程
Webhook	创建时传 callbackUrl，或在 Key 上配置默认回调	终态异步通知

银行流水多一步：先 POST .../bank-statement-valuations/materials 上传文件，再把返回的 materialRef 写入创建请求。

智能对话用于收集字段，齐备后再调上表估值接口，见 智能对话。

鉴权 Header

X-Api-Key: aai_xxxxxxxx

或 Authorization: Bearer aai_xxxxxxxx。详见 鉴权。

查询参数（创建 / 流式）

POST 创建与 POST .../stream 均支持：

参数	位置	类型	必填	说明
callbackUrl	query	string	否	本请求级 Webhook。优先于 Key 默认回调

公共可选入参

下列字段所有资产创建 / 流式请求体都可带：

字段	类型	必填	说明
source	string	否	发起入口。对话闭环请传 CHAT
chatSessionId	number	否	对话会话 ID。与 source=CHAT 一起传，便于追溯
materialFileName	string	否	材料文件名（OCR 返回）
materialRef	string	否	材料引用（OCR / 上传返回）。银行流水用 materials[]，不用本字段

JSON 响应信封

非 SSE 接口一律：

{
  "code": 0,
  "message": "success",
  "data": { }
}

code !== 0 为业务失败，见 错误码。

创建任务 data

POST /{asset}-valuations 成功时 data：

字段	类型	说明
taskId	number	任务 ID，用于查询
valuationNo	string	估值编号，如 VAL-EQP-20260818-0001
assetType	string	PROPERTY / VEHICLE / LAND / EQUIPMENT / BANK_STATEMENT
status	string	创建后一般为 IN_PROGRESS
statusLabel	string	中文状态：估值中 / 成功 / 失败
statusUrl	string	查询路径，如 /api/open/v1/equipment-valuations/123
message	string	提示文案

创建即扣费（含免费额度），与最终成功/失败无关。

查询任务 data

GET /{asset}-valuations/{taskId} 的 data：

字段	类型	说明
taskId	number	任务 ID
valuationNo	string	估值编号
assetType	string	资产类型
status	string	IN_PROGRESS / SUCCESS / FAILED
statusLabel	string	中文状态
errorMessage	string | null	仅 FAILED 时有值
result	object | null	仅 SUCCESS 时有值，结构见各资产页
createdAt	string	ISO 时间

开放详情不含对话过程、材料鉴伪等产品内字段。

资产接口一览

路径前缀均为 /api/open/v1。点击卡片查看完整入参与返回字段。

房产PROPERTY

/property-valuations

• POST创建
• GET/{id} 查询
• POST/stream 流式

入参与示例

车辆VEHICLE

/vehicle-valuations

• POST创建
• GET/{id} 查询
• POST/stream 流式

入参与示例

土地LAND

/land-valuations

• POST创建
• GET/{id} 查询
• POST/stream 流式

入参与示例

设备EQUIPMENT

/equipment-valuations

• POST创建
• GET/{id} 查询
• POST/stream 流式

入参与示例

银行流水BANK_STATEMENT

/bank-statement-valuations

• POST/materials 上传
• POST创建
• GET/{id} 查询
• POST/stream 流式

入参与示例