Оценка

Четыре инструмента оценки. Поддерживаются квартиры, дома и земельные участки; экспресс-оценка и отчет отклоняют коммерческую недвижимость и жилые комплексы с 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; отслеживание для вебхука начинается после подтверждения.

Связанные статьи

• Задачи и результаты
• Ошибки
• Лимиты и оплата