估价

四个估价工具。支持公寓、独栋住宅和土地；快速估价和估价报告会以 422 business_rule 拒绝商业物业和住宅小区；租金估算同样适用于商业物业。

快速估价

POST /valuation/express：权限范围 tools:valuation，立即返回。一次 API 调用加快速估价的价格。

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5b8c3f7e-2a71-4c55-8d0e-9f1a6b2c4d10" \
  -d '{"propertyCategory":"apartment","addressText":"Torstraße 12, Berlin","totalArea":64,"rooms":2,"currency":"EUR"}'

响应：

缺少面积或 propertyCategory 未知：400 validation；商业物业：422 business_rule，带 code: commercial_unsupported。

完整估价报告

POST /valuation/report：权限范围 tools:valuation，任务。包含市场分析和 PDF 的报告。必填字段取决于 propertyCategory。只发送您所属类别的字段：其他类别的字段（例如公寓的 houseLevels、独栋房屋的 parking）会以 400 被拒绝。仅公寓：livingArea、kitchenArea、bathrooms、ceilingHeight、floor、storeys、balcony、elevator、parking、houseType、apartmentType。仅独栋房屋：houseLevels。仅土地：zoning。独栋房屋和土地：utilities。

curl -X POST https://developers.grem.capital/api/v1/valuation/report \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "propertyCategory": "apartment",
    "address": { "country": "Germany", "city": "Berlin", "street": "Torstraße", "streetNumber": "12" },
    "currency": "EUR", "language": "zho",
    "apartmentType": "Residential", "houseType": "panel",
    "totalArea": 64, "rooms": 2, "floor": 3, "storeys": 5,
    "balcony": true, "elevator": false, "condition": "good"
  }'

响应 202：{ "jobId": "...", "status": "processing", "state": "running" }。完成的任务（GET /valuation/report/jobs/{id}）包含：

商业地产（包括 apartmentType 为 Commercial 或 Industrial）以 422 business_rule 和 code: commercial_unsupported 被拒绝；其租金可用 POST /valuation/rent 估算。住宅综合体（apartmentType: Complex）：带 code: complex_unsupported 的 422；请对其中的单套公寓或房屋估价。

PDF：GET /artifacts/v1/ai/appraisal/reports/{id}/pdf。事件：valuation.completed / valuation.failed。

租金估算

POST /valuation/rent：权限范围 tools:rent，立即返回。用字段描述物业，或传入您自己的或公开房源的 objectId。

curl -X POST https://developers.grem.capital/api/v1/valuation/rent \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"propertyCategory":"apartment","country":"Germany","city":"Berlin","totalArea":50,"rooms":2,"currency":"EUR"}'

响应：

缺少面积或城市：400，detail 类似 "Missing or invalid: totalArea"。

报告审核

POST /valuation/review：权限范围 tools:review。上传估价报告（PDF、DOCX、DOC、RTF；最大 40 MB）：GREM 读取报告并用市场数据核对价值。

请求体：multipart/form-data：

curl -X POST https://developers.grem.capital/api/v1/valuation/review \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "[email protected]" \
  -F "language=zho" -F "currency=EUR"

文件会立即读取。202 响应包含 jobId、status 和 state：

• action_required（status: need_confirm）：extracted 包含从文件中读取的数据。检查并确认：POST /valuation/review/jobs/{id}/confirm（任务与结果）。确认后任务进入 running。
• failed（status: rejected）：该文件不是房地产估价报告。

完成的结果：GET /valuation/review/jobs/{id}；审核报告：GET /artifacts/v1/ai/appraisal/reviews/{id}/report.pdf 或 report.docx。事件：review.completed / review.failed；webhook 跟踪在确认之后开始。

相关文章

• 任务与结果
• 错误
• 限制与计费