Basis pengetahuan GetMyBot

Pustaka media

Simpan foto dan berkas untuk pesan bot. Ketahui cara menggunakan pustaka media atau mengambil file_id melalui Telegram.

Di halaman ini

Jika bot sering mengirim berkas jadwal kelas atau foto yang sama, unggah berkas itu ke pustaka media agar dapat dipakai berulang kali. GetMyBot hanya menyimpan satu salinan dari berkas yang sama, meskipun Anda mengunggahnya lagi. Pustaka ini tersedia pada paket berbayar yang mencakup penyimpanan berkas (image_storage).

Untuk Telegram, ada juga cara tanpa pustaka berbayar: unggah berkas melalui obrolan layanan untuk mendapatkan file_id Telegram. Kedua cara dan batasnya dijelaskan di bawah.

Penyimpanan GetMyBot

Berkas yang diunggah disimpan di GetMyBot dan mendapat ID tersendiri. Pilih berkas tersebut dalam blok pesan Foto atau File. Saat pesan dikirim, bot menggunakan berkas yang Anda pilih. Melalui API, unggah dengan POST /api/bots/{id}/media dan buka pratinjau dengan GET /api/bots/{id}/media/{mediaID}.

Menghindari salinan berulang

Jika Anda mengunggah berkas yang sama lagi, GetMyBot menemukan salinan yang sudah ada dan mengembalikan ID sebelumnya. Berkas yang sama tidak memakai ruang penyimpanan dua kali. GetMyBot membandingkan berkas melalui nilai SHA-256, yaitu penanda yang dihitung dari isinya.

Akses paket berbayar

Pustaka media adalah fitur paket berbayar (image_storage). Paket yang aktif harus mencakup fitur ini. Tanpanya, permintaan mengunggah ke pustaka menghasilkan kesalahan 402 (pembayaran diperlukan). Anda tetap dapat melihat pratinjau berkas yang sudah tersimpan.

Ukuran satu berkas yang diunggah ke pustaka dibatasi 2 MiB.

Unggah melalui obrolan Telegram tanpa pustaka berbayar

Jika pustaka berbayar tidak tersedia, unggah berkas melalui obrolan Telegram untuk layanan. GetMyBot akan mengembalikan file_id yang dapat digunakan bot untuk mengirim berkas itu lagi. Cara ini tidak memerlukan paket berbayar; ukuran berkas tetap dibatasi 2 MiB. Dalam API, proses ini bernama sink-upload dengan alamat POST /api/bots/{id}/chats/{chatID}/sink-upload.

Pilih cara yang sesuai

Yang ingin Anda lakukanCaraYang diperlukan
Menyimpan dan memakai lagi foto yang sama, melihat pratinjau, dan menghindari duplikatPustaka mediaPaket dengan image_storage, berkas paling besar 2 MiB
Mendapatkan file_id Telegram tanpa paket berbayarsink-upload melalui obrolan layananObrolan Telegram, berkas paling besar 2 MiB

Langkah berikutnya