Medya Kitaplığı

Botun resim ve dosya göndermesi için bunların bir yerde saklanması gerekir. GetMyBot'un kendi medya kitaplığı vardır: bir dosyayı bir kez yüklersiniz ve platform onu mesajlara otomatik olarak ekler. Kitaplık aynı dosyaları tekilleştirir ve premium özellikler kapsamındadır; temel senaryo için Telegram sohbeti üzerinden ücretsiz yükleme mevcuttur.

Kendi Depolama Alanı

Yüklenen dosya platform depolama alanına kaydedilir ve bir medya tanımlayıcısı alır. Mesaj bloğundaki "Fotoğraf" veya "Dosya" bloğunda bu tanımlayıcıya başvurulabilir — gönderimde platform doğru dosyayı otomatik olarak ekler. Yükleme: POST /api/bots/{id}/media, önizleme için okuma: GET /api/bots/{id}/media/{mediaID}.

İçerik Tekilleştirmesi

Her dosya sha256 karma değeriyle tanımlanır. Aynı dosyayı tekrar yüklerseniz platform yinelenen oluşturmaz, zaten kaydedilmiş nesneye bağlantı döndürür. Bu sayede aynı resimler iki kez yer kaplamaz ve tanımlayıcı sabit kalır.

Premium Erişim

Medya kitaplığı bir premium özelliktir (image_storage). Bunu içeren ücretli bir planda kullanılabilir; aktif abonelik olmadan kitaplığa yükleme 402 (ödeme gerekli) hatası döndürür. Zaten kaydedilmiş dosyaların önizlemesi kısıtlama olmaksızın çalışır.

Kitaplığa yüklemede tek dosya boyutu 2 MiB ile sınırlıdır.

Telegram Sohbeti Üzerinden Yükleme (Premium Olmadan)

Premium kitaplık mevcut değilse ücretsiz bir yol vardır: sink-upload — POST /api/bots/{id}/chats/{chatID}/sink-upload. Dosya belirtilen Telegram sohbeti üzerinden gönderilir ve yanıtta bot mesajlarında kullanılabilecek bir Telegram file_id döner. Bu yöntem premium kapısı olmaksızın herkese açıktır; boyut sınırı aynıdır — 2 MiB.

Ne Kullanılmalı

  • Aynı resimleri düzenli olarak yeniden kullanıyor ve tekilleştirme ile önizleme istiyorsanız — medya kitaplığı (premium).
  • Abonelik olmadan hızlıca file_id almak istiyorsanız — hizmet sohbeti üzerinden sink-upload.

Sonraki Adımlar