Appearance
轮询
适合批处理与长任务。请求体字段见各资产 接口参考。
流程
POST /api/open/v1/{asset}-valuations[?callbackUrl=...]
Body: 资产入参 JSON
→ data.taskId / data.statusUrl
GET data.statusUrl(建议间隔 2~5 秒)
→ SUCCESS:data.result
→ FAILED:data.errorMessage
→ IN_PROGRESS:继续轮询| 参数 | 位置 | 说明 |
|---|---|---|
callbackUrl | query(可选) | 终态 Webhook,优先于 Key 默认回调 |
| Body | JSON | 各资产字段不同,见下表链接 |
资产路径与入参
| 资产 | 创建路径 | 入参文档 |
|---|---|---|
| 房产 | /api/open/v1/property-valuations | 房产 |
| 车辆 | /api/open/v1/vehicle-valuations | 车辆 |
| 土地 | /api/open/v1/land-valuations | 土地 |
| 设备 | /api/open/v1/equipment-valuations | 设备 |
| 银行流水 | 先 /materials,再 /bank-statement-valuations | 银行流水 |
创建与查询的通用响应字段见 约定与通用响应。
SDK
ts
const detail = await client.equipment.valuate(
{
model: "STC200",
manufactureDate: "2021-06",
manufacturer: "徐工",
},
{
intervalMs: 3000,
timeoutMs: 300_000,
onStatus: (d) => console.log(d.status),
},
);