Сайт об'єкта
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} (Об'єкти).