Ті самі інструменти, що в кабінеті, доступні програмно. Інструмент коштує стільки ж, скільки в кабінеті, плюс один виклик API (Ліміти і оплата). Базова адреса: https://developers.grem.capital/api/v1.
Перелік
| Інструмент | Запит | Область | Як працює |
|---|---|---|---|
| Експрес-оцінка | POST /valuation/express | tools:valuation | одразу |
| Повний звіт про оцінку | POST /valuation/report | tools:valuation | завдання |
| Оцінка оренди | POST /valuation/rent | tools:rent | одразу |
| Перевірка чужого звіту | POST /valuation/review | tools:review | завдання, з файлом, чекає підтвердження |
| Пакет контенту | POST /content/generate | tools:contentgen | завдання |
| Тексти оголошення | POST /text/generate | tools:text | завдання |
| Відео з фото | POST /video/create | tools:video | завдання, з файлами |
| Відео з аватаром | POST /avatar/video | tools:avatar | завдання |
| Покращення фото | POST /photo/enhance | tools:photo | завдання, з файлом |
| Очищення планування | POST /floorplan/create | tools:floorplan | одразу (відповідь 202 уже з результатом), з файлом |
| Сайт об'єкта | POST /site/create | tools:sitegen | одразу |
| PDF-презентація | POST /pdf/create | tools:pdf | завдання |
| Персональний флаєр | POST /flyer/create | tools:flyer | одразу |
| Чернетка з документів | POST /draft/extract | tools:draft | одразу, з файлами |
Поля кожного інструмента, приклади і помилки:
- Оцінка - експрес, повний звіт, оренда, перевірка звіту.
- Контент і відео - пакет контенту, тексти, відео, аватар.
- Фото і планування - покращення фото, планування.
- Матеріали оголошення - сайт, PDF, флаєр, чернетка.
Ідентифікатори, які інструменти приймають на вході (голос, аватар, музика, фінальна фраза), і поточна доступність інструментів: Довідкові дані.
Як надсилати дані
- JSON - більшість інструментів:
Content-Type: application/json. - multipart/form-data - інструменти з файлами. Формат полів у них різний, і це важливо:
- покращення фото і чернетка - параметри одним JSON-рядком у полі
data, файли окремими частинами; - відео - кожен параметр окремим полем форми (
prompt,length,musicTrackId...), фото частинамиphotos; - перевірка звіту і планування - файл у частині
file, параметри окремими полями.
- покращення фото і чернетка - параметри одним JSON-рядком у полі
Надіслати JSON інструменту, що чекає файл, - 400.
Відповіді
- Синхронний інструмент відповідає
200з результатом. - Відкладений відповідає
202із завданням; результат - опитуванням або вебхуком (Завдання і результати). - Готові файли завантажуються через
GET /artifacts/{path}.
Кожен запит, що запускає інструмент, варто надсилати з Idempotency-Key (Ідемпотентність).
Чого через API немає
3D-тур і звіт про ринок району поки доступні тільки в кабінеті.