Docs

بداية سريعة

آخر تحديث: 2026-07-212 دقيقة قراءة

تتيح لك واجهة GREM البرمجية للمطورين استدعاء أدواتنا برمجيا عبر HTTPS: تقييم العقارات، وتوليد المحتوى، وتحسين الصور، والفيديو بالأفاتار، وتوليد المواقع وملفات PDF، ودردشة الذكاء الاصطناعي. والطلبات والردود بصيغة JSON.

العنوان الأساسي

كل نقاط النهاية تحت هذا العنوان:

https://developers.grem.capital/api/v1

1. احصل على مفتاح API

افتح في اللوحة أدوات الذكاء الاصطناعي ← API وأنشئ مفتاحا في تبويب المفاتيح. ويعرض السر (gsk_live_…) مرة واحدة - انسخه فورا.

عامل المفتاح كأنه كلمة مرور: فهو يمنح الوصول إلى أدوات حسابك واحتسابه المالي. لا تضعه أبدا في نظام إدارة الإصدارات ولا تكشفه في كود المتصفح.

2. أول استدعاء

يتحقق GET /ping من المفتاح ولا يكلف شيئا:

curl -H "Authorization: Bearer gsk_live_xxx" \
  https://developers.grem.capital/api/v1/ping
{ "ok": true, "subjectId": "…", "requestId": "req_…" }

3. استدعاء أداة

مثال على استدعاء متزامن - التقييم السريع لعقار:

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"propertyCategory":"apartment","totalArea":50}'
{
  "estimate": { "pricePoint": 156250, "rangeLow": 125575, "rangeHigh": 207813, "currency": "USD" },
  "requestId": "req_…"
}

الأدوات الطويلة

أدوات مثل توليد المحتوى أو الفيديو بالأفاتار أو PDF تعيد مهمة (202 مع jobId). استعلم عن نقطة نهاية حالة المهمة (وهذا مجاني)، أو الأفضل: اشترك في webhook لتصلك إشارة عند الانتهاء. أما الملفات المولدة فتقدم عبر نطاقنا بوصفها مخرجات.

استعرض كل نقاط النهاية

مستكشف تفاعلي

جرب الطلبات مباشرة في Swagger UI على https://developers.grem.capital/docs.

مواصفة OpenAPI

استورد https://developers.grem.capital/openapi.json إلى Postman أو Insomnia، أو استخدمه لتوليد عميل.

أسئلة شائعة

من أين أحصل على مفتاح API؟

من اللوحة: أدوات الذكاء الاصطناعي > API، تبويب «المفاتيح». ويعرض السر مرة واحدة - انسخه فورا.

ما العنوان الأساسي؟

https://developers.grem.capital/api/v1

كيف أتحقق من أن المفتاح يعمل؟

استدعِ GET /ping - وهذا الاستدعاء لا يحتسب.

هل تحتسب طلبات القراءة؟

لا. فطلبات GET لا تعد استدعاءات API ولا تخصم من المحفظة، بما في ذلك الاستعلام عن حالة المهام المؤجلة.

ماذا أفعل إن أعاد الاستدعاء 402؟

هذا يعني نقص الرصيد في المحفظة أو استنفاد حصة الباقة. اشحن الرصيد أو انتقل إلى باقة أعلى.

هل كانت هذه المقالة مفيدة؟