Değerleme

Dört değerleme aracı. Daireler, evler ve arsalar desteklenir; hızlı değerleme ve rapor, ticari mülkleri ve konut sitelerini 422 business_rule ile reddeder; kira tahmini ticari mülkler için de çalışır.

Hızlı değerleme

POST /valuation/express: tools:valuation kapsamı, hemen. Bir API çağrısı artı hızlı değerleme ücreti.

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"}'

Yanıt:

Alan yoksa veya propertyCategory bilinmiyorsa 400 validation; ticari gayrimenkul code: commercial_unsupported ile 422 business_rule.

Tam değerleme raporu

POST /valuation/report: tools:valuation kapsamı, iş. Piyasa analizli ve PDF'li bir rapor. Zorunlu alanlar propertyCategory değerine bağlıdır. Yalnızca kendi kategorinizin alanlarını gönderin: başka bir kategorinin alanı (örneğin daire için houseLevels, ev için parking) 400 ile reddedilir. Yalnızca daire: livingArea, kitchenArea, bathrooms, ceilingHeight, floor, storeys, balcony, elevator, parking, houseType, apartmentType. Yalnızca ev: houseLevels. Yalnızca arsa: zoning. Ev ve arsa: 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": "tur",
    "apartmentType": "Residential", "houseType": "panel",
    "totalArea": 64, "rooms": 2, "floor": 3, "storeys": 5,
    "balcony": true, "elevator": false, "condition": "good"
  }'

202 yanıtı: { "jobId": "...", "status": "processing", "state": "running" }. Biten iş (GET /valuation/report/jobs/{id}) şunları içerir:

Ticari gayrimenkul (apartmentType Commercial veya Industrial dahil) 422 business_rule ve code: commercial_unsupported ile reddedilir; kirası POST /valuation/rent ile tahmin edilir. Konut kompleksi (apartmentType: Complex): code: complex_unsupported ile 422; içindeki tek bir daireyi veya evi değerleyin.

PDF: GET /artifacts/v1/ai/appraisal/reports/{id}/pdf. Olaylar: valuation.completed / valuation.failed.

Kira tahmini

POST /valuation/rent: tools:rent kapsamı, hemen. Mülkü alanlarla tanımlayın veya kendinize ait ya da herkese açık bir ilanın objectId değerini verin.

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"}'

Yanıt:

Alan veya şehir yoksa "Missing or invalid: totalArea" gibi bir detail ile 400.

Rapor incelemesi

POST /valuation/review: tools:review kapsamı. Bir değerleme raporu yükleyin (PDF, DOCX, DOC, RTF; 40 MB'a kadar): GREM onu okur ve değeri piyasa verileriyle karşılaştırır.

Gövde: 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=tur" -F "currency=EUR"

Belge hemen okunur. 202 yanıtı jobId, status ve state içerir:

• action_required (status: need_confirm): extracted, belgeden okunan verileri içerir. Kontrol edip onaylayın: POST /valuation/review/jobs/{id}/confirm (İşler ve sonuçlar). Onaydan sonra iş running durumuna geçer.
• failed (status: rejected): belge bir gayrimenkul değerleme raporu değil.

Biten sonuç: GET /valuation/review/jobs/{id}; inceleme raporu: GET /artifacts/v1/ai/appraisal/reviews/{id}/report.pdf veya report.docx. Olaylar: review.completed / review.failed; webhook takibi onaydan sonra başlar.

İlgili makaleler

• İşler ve sonuçlar
• Hatalar
• Limitler ve ücretlendirme