الصور والتحميل

صورة مصغرة لملف

GET/api/v1/assets/{id}/thumb

عنوان ثابت لصورة مصغرة بصيغة WebP، يحوّل إلى الملف نفسه على خادم الملفات. استخدمه مصدرًا لصورة في صفحتك مباشرة؛ لا يُحسب تحميلًا.

المفتاح: لا يحتاج مفتاحًا.
حدود الطلبات: بلا حد خاص؛ الاستجابة مخزنة مؤقتًا.
التخزين المؤقت: public, max-age=3600, s-maxage=86400
CORS: يُقرأ من أي موقع (CORS)

المعاملات

id
stringفي المسارمطلوب
معرّف الملف id من سجل العلامة.
غير الموجود يعيد 404
w
integerفي الاستعلاماختياري
الضلع الأطول بالبكسل: 128 أو 256 أو 512.
الافتراضي: 256 · القيمة غير الصالحة تُتجاهل
128256512

التحويل

يحوّل بـ 307 إلى أصغر نسخة WebP ضلعها لا يقل عن w.

رموز الحالة

307
يحوّل إلى الصورة.
404
الملف غير موجود، أو ليس منشورًا، أو لم تُصنع منه النسخة المطلوبة.
Not found

مثال

curl -sSI 'https://new.wasmenia.com/api/v1/assets/{id}/thumb'

تحميل ملف

GET/dl/{id}

يسلّم الملف الأصلي، أو نسخته المقاسة بـ v، عبر رابط موقّع صالح 5 دقائق. كل طلب يُحسب تحميلًا في إحصاءات العلامة، فاستخدمه حين يطلب القارئ الملف، لا لعرض الشعار في صفحتك.

كل طلب يُحسب تحميلًا في إحصاءات الجهة، فلا «جرّبها» هنا. ضع الرابط في <a href> يضغطه المستخدم.

المفتاح: لا يحتاج مفتاحًا.
حدود الطلبات: 120 طلبًا كل 60 ثانية لكل عنوان IP.
التخزين المؤقت: private, no-store
CORS: رابط للمستخدم يفتحه، لا لطلب من الكود

المعاملات

id
stringفي المسارمطلوب
معرّف الملف id من سجل العلامة.
غير الموجود يعيد 404
v
stringفي الاستعلاماختياري
نسخة مقاسة من الملف: png-1024 لـ PNG بضلع 1024، أو webp-512. بدونها يُسلّم الأصل.
غير الموجود يعيد 404
png-1024png-1200webp-512webp-256webp-128

التحويل

يحوّل بـ 302 إلى رابط موقّع للملف صالح 5 دقائق.

رموز الحالة

302
يحوّل إلى الملف.
404
الملف غير موجود، أو ليس منشورًا، أو لم تُصنع منه النسخة المطلوبة.
Not found
429
تجاوزت 120 تحميلًا في الدقيقة.
Too many downloads, please slow down.

مثال

curl -sSL -OJ 'https://new.wasmenia.com/dl/{id}'