Оцінка

Чотири інструменти оцінки. Підтримуються квартири, будинки і земельні ділянки; експрес-оцінка і звіт відхиляють комерційну нерухомість і житлові комплекси з 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": "eng",
    "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) - 422 з code: complex_unsupported: оцінюйте окрему квартиру або будинок у ньому.

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 МБ) - 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=eng" -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; відстеження для вебхука починається після підтвердження.

Пов'язані статті

• Завдання і результати
• Помилки
• Ліміти і оплата