Медіабібліотека

Щоб бот надсилав зображення та файли, їх потрібно десь зберігати. У GetMyBot є власна медіабібліотека: ви завантажуєте файл один раз, а платформа сама підставляє його в повідомлення. Бібліотека дедуплікує однакові файли і належить до premium-можливостей; для базового сценарію є безкоштовне завантаження через Telegram-чат.

Власне сховище

Завантажений файл зберігається у сховищі платформи і отримує ідентифікатор медіа. У блоці повідомлення «Фото» або «Файл» можна посилатися на цей ідентифікатор — при надсиланні платформа сама підставить потрібний файл. Завантаження: POST /api/bots/{id}/media, читання для попереднього перегляду: GET /api/bots/{id}/media/{mediaID}.

Дедуплікація за вмістом

Кожен файл ідентифікується за sha256-хешем вмісту. Якщо ви завантажите той самий файл повторно, платформа не створить дубль, а поверне посилання на вже збережений об'єкт. Так однакові картинки не займають місця двічі, а ідентифікатор залишається стабільним.

Premium-доступ

Медіабібліотека — premium-можливість (image_storage). Вона доступна на платному тарифі, який її включає; без активної підписки завантаження в бібліотеку повертає помилку 402 (потрібна оплата). Попередній перегляд уже збережених файлів працює без обмежень.

Розмір одного файлу при завантаженні в бібліотеку обмежений 2 МіБ.

Завантаження через Telegram-чат (без premium)

Якщо premium-бібліотека недоступна, є безкоштовний шлях: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Файл надсилається через зазначений Telegram-чат, а у відповідь повертається file_id Telegram, який можна використовувати в повідомленнях бота. Цей спосіб доступний усім без premium-гейта; обмеження на розмір — ті самі 2 МіБ.

Що використовувати

  • Регулярно повторно використовуєте ті самі картинки і хочете дедуплікацію та попередній перегляд — медіабібліотека (premium).
  • Потрібно швидко отримати file_id без підписки — sink-upload через службовий чат.

Що далі