مكتبة الوسائط

لكي يرسل البوت صوراً وملفات، يلزم تخزينها في مكان ما. لدى GetMyBot مكتبة وسائط خاصة: ترفع الملف مرة واحدة وتتولى المنصة إدراجه في الرسائل تلقائياً. تُزيل المكتبة التكرار للملفات المتطابقة وهي ضمن المزايا المميزة (premium)؛ للحالة الأساسية يتوفر رفع مجاني عبر محادثة Telegram.

مساحة التخزين الخاصة

يُحفظ الملف المرفوع في مساحة تخزين المنصة ويحصل على معرّف وسائط. في كتلة رسالة «صورة» أو «ملف» يمكن الإشارة إلى هذا المعرّف — عند الإرسال تدرج المنصة الملف المطلوب تلقائياً. الرفع: POST /api/bots/{id}/media، القراءة للمعاينة: GET /api/bots/{id}/media/{mediaID}.

إزالة التكرار بالمحتوى

يُحدَّد كل ملف بـ sha256 hash للمحتوى. إن رفعت نفس الملف مجدداً، لن تُنشئ المنصة نسخة مكررة بل ستُعيد رابطاً للكائن المحفوظ مسبقاً. هكذا لا تشغل الصور المتطابقة مساحة مضاعفة ويظل المعرّف ثابتاً.

وصول Premium

مكتبة الوسائط هي ميزة premium (image_storage). متاحة على الخطة المدفوعة التي تتضمنها؛ دون اشتراك نشط يُعيد رفع الملفات خطأ 402 (الدفع مطلوب). معاينة الملفات المحفوظة مسبقاً تعمل دون قيود.

حجم ملف واحد عند الرفع في المكتبة مقيّد بـ 2 MiB.

الرفع عبر محادثة Telegram (بدون premium)

إن لم تتوفر مكتبة premium، يوجد مسار مجاني: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. يُرسَل الملف عبر محادثة Telegram المحددة وتُعاد في الاستجابة file_id الخاص بـ Telegram يمكن استخدامه في رسائل البوت. هذه الطريقة متاحة للجميع دون قيد premium؛ حد الحجم — نفسه 2 MiB.

ماذا تستخدم

  • إن كنت تعيد استخدام نفس الصور بانتظام وتريد إزالة التكرار والمعاينة — مكتبة الوسائط (premium).
  • إن احتجت file_id بسرعة دون اشتراك — sink-upload عبر محادثة الخدمة.

الخطوات التالية