Biblioteka mediów

Aby bot wysyłał obrazy i pliki, trzeba je gdzieś przechowywać. GetMyBot posiada własną bibliotekę mediów: przesyłasz plik raz, a platforma sama wstawia go do wiadomości. Biblioteka deduplikuje identyczne pliki i jest funkcją premium; dla podstawowego scenariusza dostępne jest bezpłatne przesyłanie przez czat Telegram.

Własna biblioteka

Przesłany plik jest zapisywany w bibliotece platformy i otrzymuje identyfikator medium. W bloku wiadomości „Zdjęcie" lub „Plik" można odwołać się do tego identyfikatora — podczas wysyłania platforma sama wstawi właściwy plik. Przesyłanie: POST /api/bots/{id}/media, odczyt do podglądu: GET /api/bots/{id}/media/{mediaID}.

Deduplikacja według zawartości

Każdy plik jest identyfikowany przez skrót sha256 jego zawartości. Jeśli prześlesz ten sam plik ponownie, platforma nie utworzy duplikatu, lecz zwróci odnośnik do już zapisanego obiektu. Dzięki temu identyczne obrazy nie zajmują miejsca dwa razy, a identyfikator pozostaje stały.

Dostęp premium

Biblioteka mediów to funkcja premium (image_storage). Dostępna jest w ramach płatnego planu, który ją zawiera; bez aktywnej subskrypcji przesyłanie do biblioteki zwraca błąd 402 (wymagana płatność). Podgląd już zapisanych plików działa bez ograniczeń.

Rozmiar pojedynczego pliku przesyłanego do biblioteki jest ograniczony do 2 MiB.

Przesyłanie przez czat Telegram (bez premium)

Jeśli premium biblioteka nie jest dostępna, istnieje bezpłatna droga: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Plik jest wysyłany przez wskazany czat Telegram, a w odpowiedzi zwracany jest file_id Telegram, którego można użyć w wiadomościach bota. Ta metoda jest dostępna dla wszystkich bez bramy premium; limit rozmiaru — te same 2 MiB.

Co wybrać

  • Regularnie ponownie używasz tych samych obrazów i chcesz deduplikacji i podglądu — biblioteka mediów (premium).
  • Potrzebujesz szybko uzyskać file_id bez subskrypcji — sink-upload przez czat serwisowy.

Co dalej