تتيح لك واجهة 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، أو استخدمه لتوليد عميل.