عمليتان على الملفات: وضع صورة في GREM لإرفاقها بعقار أو تمريرها إلى أداة، واستلام النتيجة التي أنشأتها أداة.
العنوان الأساسي: https://developers.grem.capital/api/v1.
رفع صورة
curl -X POST https://developers.grem.capital/api/v1/uploads \
-H "Authorization: Bearer gsk_live_xxx" \
-F "[email protected]"
{ "files": [ { "id": "...", "url": "..." } ], "requestId": "req_..." }
يتطلب النطاق media:write. الرفع لا يُخصم.
الحدود:
| المعامل | القيمة |
|---|---|
| الصيغ | JPG، PNG، WEBP |
| ملف واحد | حتى 15 ميغابايت؛ والأكبر يعطي 413 |
| الملفات في الطلب | حتى 10 |
| الطلب كاملا | حتى 30 ميغابايت |
أسماء حقول النموذج لا تهم: أرسل من أجزاء الملفات ما تسمح به الحدود.
ضع قيم id المعادة في photos عند إنشاء عقار أو تعديله (العقارات)، وقيم url حيثما تأخذ الأداة عناوين صور (حزمة المحتوى، form.media.photos):
{ "photos": ["<معرّف الملف الأول>", "<معرّف الملف الثاني>"] }
رابط الأصل يصلك أنت فقط. بعد إرفاق الصورة بعقار منشور، يقدم الكتالوج للآخرين النسخ ذات العلامة المائية فقط.
تنزيل نتيجة
نزّل الملفات عبر نطاق GREM بالمفتاح نفسه:
curl -H "Authorization: Bearer gsk_live_xxx" \
https://developers.grem.capital/api/v1/artifacts/<path> \
-o presentation.pdf
يتطلب النطاق tools:artifacts. التنزيل طلب GET، لذا فهو مجاني ولا يُحتسب استدعاء API.
التنزيل الجزئي عبر الترويسة Range مدعوم: يمكن تنزيل الفيديوهات والعروض الكبيرة على أجزاء أو استئنافها.
المفتاح مطلوب هنا أيضا: رابط النتيجة ليس عاما. لا تضمّنه في صفحة يراها زوارك، بل قدّم الملف من خادمك.
لا يمكن تمرير مسار عشوائي: لا تُقبل إلا مسارات تنزيل النتائج وملفات /files/...، وكل ما عداها يعيد 404. القائمة الكاملة للمسارات في المهام والنتائج.
مقالات ذات صلة
- الأدوات عبر API: ما الذي ينشئ هذه الملفات.
- العقارات: شكل العقار والصور.
- الأخطاء: رموز الرفض.