کتابخانه رسانه

برای اینکه بات تصاویر و فایل‌ها ارسال کند، باید آن‌ها را جایی ذخیره کرد. GetMyBot دارای کتابخانه رسانه اختصاصی است: فایل را یک بار آپلود می‌کنید و پلتفرم آن را خودکار در پیام‌ها درج می‌کند. کتابخانه فایل‌های تکراری را حذف می‌کند و از قابلیت‌های premium است؛ برای سناریوی پایه، آپلود رایگان از طریق Telegram در دسترس است.

ذخیره‌سازی اختصاصی

فایل آپلودشده در ذخیره‌سازی پلتفرم ذخیره و یک شناسه رسانه دریافت می‌کند. در بلوک پیام «عکس» یا «فایل» می‌توان به این شناسه ارجاع داد — هنگام ارسال پلتفرم خودکار فایل مناسب را درج می‌کند. آپلود: POST /api/bots/{id}/media، خواندن برای پیش‌نمایش: GET /api/bots/{id}/media/{mediaID}.

حذف تکراری بر اساس محتوا

هر فایل با هش sha256 محتوا شناسایی می‌شود. اگر همان فایل را دوباره آپلود کنید، پلتفرم تکرار ایجاد نمی‌کند، بلکه لینک به شیء ذخیره‌شده قبلی را برمی‌گرداند. این‌گونه تصاویر یکسان دو بار فضا نمی‌گیرند و شناسه ثابت می‌ماند.

دسترسی 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 از طریق چت سرویسی.

بیشتر بخوانید