v10.3 185 metot
Ana sayfa Dokümantasyon Test aracı Mini App Geri bildirim
TR

Telegram Bot API Dokümantasyonu: Swagger ve OpenAPI 3.1

Telegram Bot API Swagger, etkileşimli bir Telegram Bot API dokümantasyonudur: Bot API 10.3'ün 185 metodunun tamamı için hazırlanmış, 19 etikete (tag) ayrılmış ve Swagger UI ile görüntülenen bir OpenAPI 3.1 tanımı. Her metotta türleri ve zorunluluk bilgisiyle parametreler ile resmi dokümantasyona bağlantı bulunur; metodu bot token'ınızla canlı olarak çalıştırabilirsiniz.

Swagger'da Telegram Bot API dokümantasyonu nasıl kullanılır?

  1. @BotFather üzerinden bir bot token'ı alın; bkz. Telegram bot token nasıl alınır.
  2. Authorize düğmesine tıklayıp token'ı yapıştırın. İstekler https://api.telegram.org/bot<token>/METHOD_NAME adresine gider; sunucu (server) bloğunda bir token değişkeni görünüyorsa onu da doldurun.
  3. Mesajlar, güncellemeler veya geçici mesajlar gibi bir etiketi açın ya da listeyi filtre kutusuyla daraltın.
  4. Bir metodu açın, Try it out düğmesine tıklayın, JSON gövdesini düzenleyin (sendMessage için chat_id ve text) ve Execute ile gönderin.
  5. Durum kodunu, yanıt gövdesini, istek süresini ve oluşturulan curl komutunu kontrol edin.

Swagger dokümantasyonu ne zaman işe yarar?

"Try it out" gerçek istek gönderir: sendMessage gerçekten mesaj yollar, deleteWebhook webhook'unuzu gerçekten kaldırır. Denemeleri ayrı bir test botuyla yapın.

Telegram Bot API Türkçe kaynakları

Swagger, OpenAPI tanımını şema olarak gösterir. Her metodun Türkçe açıklamasını, parametre tablosunu ve curl, Python, JavaScript örneklerini ayrı bir sayfada görmek isterseniz Türkçe metot referansını açın. Henüz botunuz yoksa ilk adımlar Telegram bot oluşturma rehberinde anlatılıyor.

Gizlilik

Swagger tamamen tarayıcınızda çalışır. İstekler sayfadan doğrudan api.telegram.org adresine gider; token'ınız ve API trafiğiniz sunucularımızdan geçmez. Token yine de sızarsa @BotFather'da /revoke komutuyla iptal edin.

Türe göre formlar, long polling ve güncelleme geçmişi için Bot API Tester aracını kullanın. Mini App geliştiriyorsanız Telegram.WebApp API'sini Mini App Tester ile test edin.

Sık sorulan sorular

Telegram Bot API için OpenAPI spesifikasyonu var mı?

Telegram, Bot API'yi core.telegram.org üzerinde belgeler. Bu sayfa, Bot API 10.3'ün 185 metodunun tamamı için bağımsız bir OpenAPI 3.1 tanımı ve onun üzerinde Swagger UI sunar; resmi bir Telegram ürünü değildir.

Telegram Bot API Swagger'da nasıl yetkilendirme yapılır?

Authorize düğmesine tıklayıp @BotFather'dan aldığınız token'ı yapıştırın; sunucu bloğunda bir token değişkeni görünüyorsa onu da doldurun. Ardından istekler tarayıcınızdan doğrudan https://api.telegram.org/bot<token>/METHOD_NAME adresine gider.

Try it out gerçek istek gönderir mi?

Evet. Execute, token'ınızla gerçek Bot API'yi çağırır; sendMessage, deleteMessage, setWebhook veya logOut gibi metotların etkisi gerçektir. Denemeler için bir test botu kullanın.

Telegram Bot API dokümantasyonunun Türkçesi var mı?

Evet: Türkçe metot referansında her metodun kısa Türkçe açıklaması, parametre tablosu ve curl, Python, JavaScript örnekleri bulunur. Resmi ve en ayrıntılı metin core.telegram.org adresinde İngilizcedir.

Bu dokümantasyon hangi Bot API sürümünü kapsıyor?

Bot API 10.3 (24 Ağustos 2026): zengin mesajlar ve geçici mesajlar dahil 19 etiketteki 185 metodun tamamı; her metotta resmi dokümantasyona bağlantı vardır.

Swagger mı, Bot API Tester mı kullanmalıyım?

Referansa göz atmak, istek şemalarını karşılaştırmak ve curl komutu kopyalamak için Swagger'ı kullanın. Türe göre formlar, güncelleme geçmişiyle long polling ve hızlı token kontrolü için Bot API Tester daha uygundur.