Сайт объекта
POST /site/create - область tools:sitegen, отвечает сразу. Лендинг со ссылкой для объекта - вашего или любого публичного.
| Поле | Тип | Описание |
|---|---|---|
objectId | строка | обязательное: id объекта |
siteName | строка | название ссылки в вашем списке |
language | строка | ENG (по умолчанию), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
coverPhotoId | строка | фото объекта, которое показать первым |
brandColor | строка | цвет акцента #RRGGBB |
showPhone | да/нет | показать ваш телефон на странице (по умолчанию нет) |
curl -X POST https://developers.grem.capital/api/v1/site/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"objectId":"OBJECT_ID","siteName":"Torstraße 12","language":"ENG"}'
Ответ:
| Поле | Описание |
|---|---|
landingId | id сайта |
baseUrl | адрес сайта |
link | созданная ссылка: название, язык, код и адрес |
Без objectId - 400; недоступный объект - 403 или 404.
PDF-презентация
POST /pdf/create - область tools:pdf, задача. Брендированный PDF для объекта - вашего или любого публичного.
| Поле | Тип | Описание |
|---|---|---|
pdfName | строка | обязательное: название документа, до 200 символов |
objectId | строка | обязательное: id объекта |
language | строка | ENG (по умолчанию), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
descriptionType | строка | presentation (по умолчанию), description или social |
currency | строка | UAH, USD, EUR, AZN, GBP, AED, CNY, TRY, GEL |
priceForPdf | число | другая цена для документа |
coverPhotoId | строка | фото для обложки |
descriptionOverride | строка | свой текст только для этого документа, до 3000 символов |
brandColor | строка | цвет акцента #RRGGBB |
curl -X POST https://developers.grem.capital/api/v1/pdf/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"pdfName":"Torstraße 12 - presentation","objectId":"OBJECT_ID","language":"ENG"}'
Язык - только заглавными буквами из этого списка: ru или en дают 400.
Ответ 202 с jobId. Готовая задача (GET /pdf/create/jobs/{id}):
| Поле | Описание |
|---|---|
link | прямой адрес документа |
pageCount | страниц |
sizeBytes | размер |
coverImageUrl | обложка |
Файл также доступен через GET /artifacts/v1/ai/pdf-generator/files/{id}/download. События - pdf.completed / pdf.failed.
Персональный флаер
POST /flyer/create - область tools:flyer, отвечает сразу. Флаер брокера (A4, квадрат или сторис) с вашим фото, цифрами платформы и QR-кодом на вашу реферальную ссылку. Сам флаер бесплатный, списывается только вызов API.
| Поле | Тип | Описание |
|---|---|---|
language | строка | ENG (по умолчанию) и другие коды как у сайта; регистр не важен |
layouts | массив | a4 (печать), feed45, square, story, link; по умолчанию ["a4"]; хотя бы один; регистр не важен |
formats | массив | png, jpg, pdf; по умолчанию ["png","pdf"]. PDF печатается только для a4; от одного до трех; регистр не важен |
name, role, city, kicker | строка | имя, роль, город, подзаголовок |
photoRef | строка | avatar - фото вашего профиля, или изображение как data:image/... |
ctaUrl | строка | реферальная ссылка для QR (только домены платформы) |
slogan | массив | до 2 строк |
features | массив | до 6 пунктов { "icon", "title" }; icon - crm, ai, globe, publisher, marketing, shield, wallet, chart, lock или handshake |
joinTitle, joinNote | строка | призыв присоединиться |
builtFor | массив | для кого, до 6 строк |
footer | массив | до 2 строк |
contacts | объект | контакты: телефон, почта и т. д. |
Неизвестные поля отбрасываются.
curl -X POST https://developers.grem.capital/api/v1/flyer/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"language":"ENG","layouts":["a4"],"formats":["pdf"],"name":"Anna Schmidt","role":"Real estate agent","city":"Berlin","photoRef":"avatar"}'
Ответ:
| Поле | Описание |
|---|---|
files | готовые файлы |
files[].layout, files[].format | формат и тип файла |
files[].width, files[].height, files[].bytes | размер |
files[].path | путь для скачивания: https://developers.grem.capital/api/v1/artifacts + path |
ctaUrl | ссылка, зашитая в QR |
historyId | запись в истории флаеров |
Черновик из документов или сайта
POST /draft/extract - область tools:draft, отвечает сразу. GREM читает брошюры, прайсы или сайт застройщика и создает черновик объекта с полями и фото. Лимит: 2 черновика в сутки на аккаунт; следующий отклоняется с 403 до следующего дня. Списывается только вызов API, цены инструмента нет.
Тело - multipart/form-data:
| Часть | Описание |
|---|---|
data | JSON-строка: {"type": "property"} или {"type": "complex"}, при необходимости с "site": "https://..." - обязательное |
| файлы | документы (PDF, DOC/DOCX, изображения) под любыми именами частей |
Нужны либо файлы, либо site в data, иначе 400 с полем files.
curl -X POST https://developers.grem.capital/api/v1/draft/extract \
-H "Authorization: Bearer gsk_live_xxx" \
-F 'data={"type":"complex"}' \
-F "[email protected]" -F "[email protected]"
Ответ - созданный черновик (не опубликован). Просмотрите и дополните его через GET /objects/{kind}/{id} и PUT /objects/{kind}/{id} (Объекты).