مواد الإعلان

آخر تحديث: 2026-10-034 دقيقة قراءة

صفحة هبوط العقار

POST /site/create: النطاق tools:sitegen، فوري. صفحة هبوط برابط قابل للمشاركة لعقار: عقارك أو أي عقار عام.

الحقل	النوع	الوصف
`objectId`	نص	إلزامي: معرّف العقار
`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":"ARB"}'

الرد:

الحقل	الوصف
`landingId`	معرّف الموقع
`baseUrl`	عنوان الموقع
`link`	الرابط المُنشأ: الاسم، واللغة، والرمز، والعنوان

دون objectId: 400؛ عقار غير متاح: 403 أو 404.

عرض PDF

POST /pdf/create: النطاق tools:pdf، مهمة. ملف PDF بعلامتك التجارية لعقار: عقارك أو أي عقار عام.

الحقل	النوع	الوصف
`pdfName`	نص	إلزامي: اسم المستند، حتى 200 حرف
`objectId`	نص	إلزامي: معرّف العقار
`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 - عرض تقديمي","objectId":"OBJECT_ID","language":"ARB"}'

يجب أن تكون اللغة بأحرف كبيرة ومن هذه القائمة: 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`	مصفوفة	حتى سطرين
`features`	مصفوفة	حتى 6 عناصر `{ "icon", "title" }`؛ `icon` إحدى القيم `crm`، `ai`، `globe`، `publisher`، `marketing`، `shield`، `wallet`، `chart`، `lock`، `handshake`
`joinTitle`، `joinNote`	نص	دعوة للانضمام
`builtFor`	مصفوفة	لمن، حتى 6 أسطر
`footer`	مصفوفة	حتى سطرين
`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":"ARB","layouts":["a4"],"formats":["pdf"],"name":"Anna Schmidt","role":"وكيلة عقارية","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 الكتيبات أو قوائم الأسعار أو موقع المطور وينشئ مسودة عقار بالحقول والصور. الحد: مسودتان في اليوم لكل حساب؛ والتالية تُرفض بـ 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} (العقارات).

صفحة هبوط العقار

عرض PDF

النشرة الشخصية

مسودة من مستندات أو من موقع ويب

مقالات ذات صلة