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