Qiymətləndirmə

Dörd qiymətləndirmə aləti. Mənzillər, evlər və torpaq sahələri dəstəklənir; ekspres qiymətləndirmə və hesabat kommersiya daşınmaz əmlakından və yaşayış komplekslərindən 422 business_rule ilə imtina edir; icarə qiymətləndirməsi kommersiya əmlakı üçün də işləyir.

Ekspres qiymətləndirmə

POST /valuation/express - scope tools:valuation, dərhal. Bir API çağırışı üstəgəl ekspres qiymətləndirmənin qiyməti.

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

Cavab:

Sahə göstərilməyibsə və ya propertyCategory naməlumdursa - 400 validation; kommersiya əmlakı - 422 business_rule və code: commercial_unsupported.

Qiymətləndirmə 30-150 saniyə çəkir, API-nin qarşısındakı şəbəkə isə ~100 saniyə ərzində başlamayan cavabı 524 ilə kəsir. Buna görə Idempotency-Key və Prefer: respond-async başlığını göndərin: 202 dərhal { "jobId", "status", "state", "links": { "self" } } ilə və Location, Retry-After başlıqları ilə gəlir. GET /valuation/express/jobs/{id} ünvanını (pulsuz) state dəyəri completed (result sinxron 200 ilə eyni gövdəni ehtiva edir) və ya failed (error eyni problemi ehtiva edir) olana qədər sorğulayın. Sorğulama əvəzinə express.completed / express.failed hadisələrinə abunə ola bilərsiniz (Vebhuklar). Ödəniş sinxron çağırışda olduğu kimi bir dəfə tutulur; tapşırıq 7 gün saxlanılır. Başlıq olmadan cavab sinxron qalır.

Tam qiymətləndirmə hesabatı

POST /valuation/report - scope tools:valuation, tapşırıq. Bazar təhlili və PDF ilə hesabat. Mütləq sahələr propertyCategory dəyərindən asılıdır. Yalnız öz kateqoriyanızın sahələrini göndərin: başqa kateqoriyanın sahəsi (məsələn, mənzil üçün houseLevels, ev üçün parking) 400 ilə rədd edilir. Yalnız mənzil: livingArea, kitchenArea, bathrooms, ceilingHeight, floor, storeys, balcony, elevator, parking, houseType, apartmentType. Yalnız ev: houseLevels. Yalnız torpaq: zoning. Ev və torpaq: 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": "eng",
    "apartmentType": "Residential", "houseType": "panel",
    "totalArea": 64, "rooms": 2, "floor": 3, "storeys": 5,
    "balcony": true, "elevator": false, "condition": "good"
  }'

202 cavabı: { "jobId": "...", "status": "processing", "state": "running" }. Tamamlanmış tapşırıq (GET /valuation/report/jobs/{id}) bunları ehtiva edir:

Kommersiya əmlakı (o cümlədən apartmentType Commercial və ya Industrial) 422 business_rule və code: commercial_unsupported ilə rədd edilir - onun icarəsini POST /valuation/rent ilə qiymətləndirin. Yaşayış kompleksi (apartmentType: Complex) - 422 və code: complex_unsupported: kompleksdəki bir mənzili və ya evi qiymətləndirin.

PDF: GET /artifacts/v1/ai/appraisal/reports/{id}/pdf. Hadisələr - valuation.completed / valuation.failed.

İcarə qiymətləndirməsi

POST /valuation/rent - scope tools:rent, dərhal. Əmlakı sahələrlə təsvir edin və ya öz elanınızın, yaxud ictimai elanın objectId dəyərini ötürün.

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

Cavab:

Sahə və ya şəhər olmadan - 400 və "Missing or invalid: totalArea" kimi detail.

İcarə qiymətləndirməsi də bir dəqiqədən çox çəkə bilər. Prefer: respond-async ilə dərhal tapşırıqla 202 cavabı verir; status: GET /valuation/rent/jobs/{id} (pulsuz), hadisələr: rent.completed / rent.failed. Qalan hər şey yuxarıdakı ekspres qiymətləndirmədə olduğu kimi işləyir.

Hesabatın yoxlanması

POST /valuation/review - scope tools:review. Qiymətləndirmə hesabatını yükləyin (PDF, DOCX, DOC, RTF; 40 MB-a qədər) - GREM onu oxuyur və dəyəri bazar məlumatları ilə yoxlayır.

Gövdə - multipart/form-data:

curl -X POST https://developers.grem.capital/api/v1/valuation/review \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "file=@report.pdf" \
  -F "language=eng" -F "currency=EUR"

Sənəd dərhal oxunur. 202 cavabı jobId, status və state sahələrini ehtiva edir:

• action_required (status: need_confirm) - extracted sənəddən oxunmuş məlumatları ehtiva edir. Onları yoxlayın və təsdiqləyin: POST /valuation/review/jobs/{id}/confirm (Tapşırıqlar və nəticələr). Təsdiqdən sonra tapşırıq running vəziyyətinə keçir.
• failed (status: rejected) - sənəd daşınmaz əmlakın qiymətləndirmə hesabatı deyil.

Hazır nəticə - GET /valuation/review/jobs/{id}; yoxlama hesabatı - GET /artifacts/v1/ai/appraisal/reviews/{id}/report.pdf və ya report.docx. Hadisələr - review.completed / review.failed; vebhuk izləməsi təsdiqdən sonra başlayır. Sənəd oxunub və təsdiq lazımdırsa, yoxlamanın id-si ilə review.action_required hadisəsi gəlir.

Böyük sənədin oxunması dəqiqələr çəkə bilər, ~100 saniyə ərzində başlamayan cavab isə 524 ilə kəsilir. Idempotency-Key və Prefer: respond-async başlığı ilə 202 fayl yüklənən kimi sorğu tapşırığı ilə gəlir (areq_… kimi jobId, Preference-Applied: respond-async, Location, Retry-After). Bu id ilə GET /valuation/review/jobs/{id} ünvanını (pulsuz) state dəyəri completed olana qədər sorğulayın: result yuxarıda təsvir edilən 202 cavabını olduğu kimi ehtiva edir - yoxlamanı almaq və təsdiqləmək üçün onun result.jobId dəyərindən istifadə edin (POST /valuation/review/jobs/{id}/confirm). Sorğu tapşırığı üçün review.completed sənədin oxunduğunu və təsdiq gözlədiyini bildirir. code: interrupted ilə uğursuz olan tapşırıq üçün ödəniş tutulmur və açar azad edilir: eyni sorğunu eyni açarla yenidən göndərin. Başlıq olmadan cavab əvvəlki kimidir.

Əlaqəli

• Tapşırıqlar və nəticələr
• Xətalar
• Limitlər və ödəniş