Objekt-Landingpage
POST /site/create - Bereich tools:sitegen, sofort. Eine Landingpage mit teilbarem Link für ein Objekt - Ihres oder ein beliebiges öffentliches.
| Feld | Typ | Beschreibung |
|---|---|---|
objectId | String | Pflicht: Objekt-ID |
siteName | String | Name des Links in Ihrer Liste |
language | String | ENG (Standard), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
coverPhotoId | String | Objektfoto, das zuerst gezeigt wird |
brandColor | String | Akzentfarbe #RRGGBB |
showPhone | ja/nein | Ihre Telefonnummer auf der Seite zeigen (Standard nein) |
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":"DEU"}'
Antwort:
| Feld | Beschreibung |
|---|---|
landingId | Website-ID |
baseUrl | Website-Adresse |
link | der erstellte Link: Name, Sprache, Code und Adresse |
Ohne objectId - 400; ein nicht zugängliches Objekt - 403 oder 404.
PDF-Präsentation
POST /pdf/create - Bereich tools:pdf, Auftrag. Ein gebrandetes PDF für ein Objekt - Ihres oder ein beliebiges öffentliches.
| Feld | Typ | Beschreibung |
|---|---|---|
pdfName | String | Pflicht: Dokumentname, bis 200 Zeichen |
objectId | String | Pflicht: Objekt-ID |
language | String | ENG (Standard), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
descriptionType | String | presentation (Standard), description oder social |
currency | String | UAH, USD, EUR, AZN, GBP, AED, CNY, TRY, GEL |
priceForPdf | Zahl | ein anderer Preis für das Dokument |
coverPhotoId | String | Titelfoto |
descriptionOverride | String | eigener Text nur für dieses Dokument, bis 3000 Zeichen |
brandColor | String | Akzentfarbe #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 - Präsentation","objectId":"OBJECT_ID","language":"DEU"}'
Die Sprache muss in Großbuchstaben aus dieser Liste kommen: ru oder en ergeben 400.
202 mit jobId. Der fertige Auftrag (GET /pdf/create/jobs/{id}):
| Feld | Beschreibung |
|---|---|
link | direkte Adresse des Dokuments |
pageCount | Seiten |
sizeBytes | Größe |
coverImageUrl | Titelbild |
Die Datei ist auch unter GET /artifacts/v1/ai/pdf-generator/files/{id}/download verfügbar. Ereignisse - pdf.completed / pdf.failed.
Persönlicher Flyer
POST /flyer/create - Bereich tools:flyer, sofort. Ein Makler-Flyer (A4, quadratisch oder Story) mit Ihrem Foto, Plattformkennzahlen und einem QR-Code zu Ihrem Empfehlungslink. Der Flyer selbst ist kostenlos; berechnet wird nur der API-Aufruf.
| Feld | Typ | Beschreibung |
|---|---|---|
language | String | ENG (Standard) und die übrigen Codes wie bei der Landingpage; Groß-/Kleinschreibung egal |
layouts | Array | a4 (Druck), feed45, square, story, link; Standard ["a4"]; mindestens eines; Groß-/Kleinschreibung egal |
formats | Array | png, jpg, pdf; Standard ["png","pdf"]. PDF wird nur für a4 erzeugt; eins bis drei; Groß-/Kleinschreibung egal |
name, role, city, kicker | String | Name, Rolle, Stadt, Untertitel |
photoRef | String | avatar - Ihr Profilfoto, oder ein Bild als data:image/... |
ctaUrl | String | Empfehlungslink für den QR-Code (nur Plattformdomains) |
slogan | Array | bis 2 Zeilen |
features | Array | bis 6 Einträge { "icon", "title" }; icon - crm, ai, globe, publisher, marketing, shield, wallet, chart, lock oder handshake |
joinTitle, joinNote | String | Aufruf zum Beitritt |
builtFor | Array | für wen, bis 6 Zeilen |
footer | Array | bis 2 Zeilen |
contacts | Objekt | Kontakte: Telefon, E-Mail usw. |
Unbekannte Felder werden verworfen.
curl -X POST https://developers.grem.capital/api/v1/flyer/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"language":"DEU","layouts":["a4"],"formats":["pdf"],"name":"Anna Schmidt","role":"Immobilienmaklerin","city":"Berlin","photoRef":"avatar"}'
Antwort:
| Feld | Beschreibung |
|---|---|
files | erzeugte Dateien |
files[].layout, files[].format | Layout und Dateityp |
files[].width, files[].height, files[].bytes | Größe |
files[].path | Downloadpfad: https://developers.grem.capital/api/v1/artifacts + path |
ctaUrl | der im QR-Code gedruckte Link |
historyId | Eintrag im Flyer-Verlauf |
Entwurf aus Dokumenten oder einer Website
POST /draft/extract - Bereich tools:draft, sofort. GREM liest Broschüren, Preislisten oder die Website eines Bauträgers und legt einen Objektentwurf mit Feldern und Fotos an. Limit: 2 Entwürfe pro Tag und Konto; der nächste wird bis zum Folgetag mit 403 abgelehnt. Berechnet wird nur der API-Aufruf, es gibt keinen Werkzeugpreis.
Body - multipart/form-data:
| Teil | Beschreibung |
|---|---|
data | JSON-String: {"type": "property"} oder {"type": "complex"}, optional mit "site": "https://..." - Pflicht |
| Dateien | Dokumente (PDF, DOC/DOCX, Bilder) unter beliebigen Teilnamen |
Senden Sie entweder Dateien oder site in data, sonst 400 mit dem Feld 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]"
Die Antwort ist der angelegte Entwurf (nicht veröffentlicht). Prüfen und ergänzen Sie ihn mit GET /objects/{kind}/{id} und PUT /objects/{kind}/{id} (Objekte).