İlan açılış sayfası
POST /site/create: tools:sitegen kapsamı, hemen. Bir ilan için paylaşılabilir bağlantılı bir açılış sayfası: sizin ilanınız veya herhangi bir herkese açık ilan.
| Alan | Tür | Açıklama |
|---|---|---|
objectId | dize | zorunlu: ilan kimliği |
siteName | dize | listenizdeki bağlantı adı |
language | dize | ENG (varsayılan), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
coverPhotoId | dize | ilk gösterilecek ilan fotoğrafı |
brandColor | dize | vurgu rengi #RRGGBB |
showPhone | evet/hayır | sayfada telefonunuzu gösterme (varsayılan hayır) |
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":"TUR"}'
Yanıt:
| Alan | Açıklama |
|---|---|
landingId | site kimliği |
baseUrl | site adresi |
link | oluşturulan bağlantı: ad, dil, kod ve adres |
objectId yoksa 400; erişilemeyen bir ilan 403 veya 404.
PDF sunum
POST /pdf/create: tools:pdf kapsamı, iş. Bir ilan için markalı bir PDF: sizin ilanınız veya herhangi bir herkese açık ilan.
| Alan | Tür | Açıklama |
|---|---|---|
pdfName | dize | zorunlu: belge adı, 200 karaktere kadar |
objectId | dize | zorunlu: ilan kimliği |
language | dize | ENG (varsayılan), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
descriptionType | dize | presentation (varsayılan), description veya social |
currency | dize | UAH, USD, EUR, AZN, GBP, AED, CNY, TRY, GEL |
priceForPdf | sayı | belge için farklı bir fiyat |
coverPhotoId | dize | kapak fotoğrafı |
descriptionOverride | dize | yalnızca bu belge için kendi metniniz, en fazla 3000 karakter |
brandColor | dize | vurgu rengi #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 - sunum","objectId":"OBJECT_ID","language":"TUR"}'
Dil bu listeden ve büyük harfle olmalıdır: ru veya en 400 döndürür.
jobId ile 202. Biten iş (GET /pdf/create/jobs/{id}):
| Alan | Açıklama |
|---|---|
link | belgenin doğrudan adresi |
pageCount | sayfa sayısı |
sizeBytes | boyut |
coverImageUrl | kapak |
Dosya ayrıca GET /artifacts/v1/ai/pdf-generator/files/{id}/download adresinden alınabilir. Olaylar: pdf.completed / pdf.failed.
Kişisel broşür
POST /flyer/create: tools:flyer kapsamı, hemen. Fotoğrafınız, platform rakamları ve referans bağlantınıza giden bir QR kod içeren bir emlakçı broşürü (A4, kare veya hikâye). Broşürün kendisi ücretsizdir; yalnızca API çağrısı ücretlendirilir.
| Alan | Tür | Açıklama |
|---|---|---|
language | dize | ENG (varsayılan) ve diğer kodlar, açılış sayfasındaki gibi; büyük/küçük harf fark etmez |
layouts | dizi | a4 (baskı), feed45, square, story, link; varsayılan ["a4"]; en az bir tane; büyük/küçük harf fark etmez |
formats | dizi | png, jpg, pdf; varsayılan ["png","pdf"]. PDF yalnızca a4 için üretilir; birden üçe kadar; büyük/küçük harf fark etmez |
name, role, city, kicker | dize | ad, rol, şehir, alt başlık |
photoRef | dize | avatar: profil fotoğrafınız, veya data:image/... biçiminde bir görsel |
ctaUrl | dize | QR için referans bağlantısı (yalnızca platform alan adları) |
slogan | dizi | en fazla 2 satır |
features | dizi | en fazla 6 öğe { "icon", "title" }; icon: crm, ai, globe, publisher, marketing, shield, wallet, chart, lock veya handshake |
joinTitle, joinNote | dize | katılma çağrısı |
builtFor | dizi | kimler için, en fazla 6 satır |
footer | dizi | en fazla 2 satır |
contacts | nesne | iletişim: telefon, e-posta vb. |
Bilinmeyen alanlar atılır.
curl -X POST https://developers.grem.capital/api/v1/flyer/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"language":"TUR","layouts":["a4"],"formats":["pdf"],"name":"Anna Schmidt","role":"Emlak danışmanı","city":"Berlin","photoRef":"avatar"}'
Yanıt:
| Alan | Açıklama |
|---|---|
files | oluşturulan dosyalar |
files[].layout, files[].format | düzen ve dosya türü |
files[].width, files[].height, files[].bytes | boyut |
files[].path | indirme yolu: https://developers.grem.capital/api/v1/artifacts + path |
ctaUrl | QR'a basılan bağlantı |
historyId | broşür geçmişindeki kayıt |
Belgelerden veya bir web sitesinden taslak
POST /draft/extract: tools:draft kapsamı, hemen. GREM broşürleri, fiyat listelerini veya bir geliştiricinin web sitesini okur ve alanları ve fotoğraflarıyla bir ilan taslağı oluşturur. Limit: hesap başına günde 2 taslak; sonraki, ertesi güne kadar 403 ile reddedilir. Yalnızca API çağrısı ücretlendirilir, araç ücreti yoktur.
Gövde: multipart/form-data:
| Parça | Açıklama |
|---|---|
data | JSON dizesi: {"type": "property"} veya {"type": "complex"}, isteğe bağlı olarak "site": "https://..." ile: zorunlu |
| dosyalar | herhangi bir parça adıyla belgeler (PDF, DOC/DOCX, görseller) |
Dosyaları veya data içinde site gönderin; aksi hâlde files alanıyla 400.
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]"
Yanıt, oluşturulan taslaktır (yayınlanmamış). GET /objects/{kind}/{id} ve PUT /objects/{kind}/{id} ile kontrol edip tamamlayın (İlanlar).