v10.3 185 методов
Главная Документация Тестер Mini App Обратная связь
RU

Telegram Bot API Swagger — OpenAPI 3.1 для 185 методов

Telegram Bot API Swagger — интерактивная документация Telegram Bot API в формате OpenAPI 3.1: спецификация всех 185 методов версии 10.3. Здесь удобно изучать API как справочник: методы сгруппированы по темам, у каждого — параметры с типами, обязательные поля, коды ответов и ссылка на официальную документацию. Запрос можно выполнить прямо со страницы кнопкой Try it out.

Как пользоваться

  1. Найдите метод в одной из 19 групп или отфильтруйте список по названию группы в поле фильтра.
  2. Раскройте метод: увидите описание, параметры с типами, отметки обязательных полей и ссылку на раздел на core.telegram.org.
  3. Впишите токен бота в переменную token в блоке Servers — адрес сервера выглядит как https://api.telegram.org/bot{token}. Токен можно получить у @BotFather.
  4. Нажмите Try it out, заполните параметры и нажмите Execute.
  5. Изучите ответ: Swagger UI показывает код ответа, тело JSON, итоговый Request URL и готовую команду curl, которую можно скопировать в терминал или скрипт.

Что внутри спецификации

Методы разбиты на 19 групп: информация о боте, обновления, сообщения, rich-сообщения, эфемерные сообщения, редактирование, медиа, оплата, опросы, обратные вызовы, чат, администрирование, форум, файлы, стикеры, игры, истории, бизнес и прочее. Отдельные группы для rich- и эфемерных сообщений помогают быстро найти новинки Bot API 10.1–10.3: sendRichMessage, sendRichMessageDraft, editEphemeralMessageText, deleteEphemeralMessage и другие.

Когда пригодится

Приватность

У страницы нет собственного сервера: запросы Try it out отправляет ваш браузер напрямую на api.telegram.org, токен никуда больше не передаётся. Для экспериментов удобнее отдельный тестовый бот, а если токен утёк, отзовите его командой /revoke в @BotFather.

Практические инструкции: как отправить сообщение через бота, настройка вебхука, лимиты Telegram Bot API и что нового в Bot API 10.3. Подробные страницы методов с примерами на curl, Python и JavaScript — в справочнике методов. Чтобы вызывать методы через удобные формы с long polling, откройте Bot API Tester, а для проверки Telegram WebApp API — Mini App Tester.

Частые вопросы

Это официальная документация Telegram?

Нет, это независимый проект. OpenAPI 3.1 спецификация собрана по официальной документации Bot API 10.3, а у каждого метода есть ссылка на первоисточник на core.telegram.org.

Как выполнить запрос к Telegram Bot API из Swagger?

Впишите токен бота в переменную token в блоке Servers — она подставляется в адрес https://api.telegram.org/bot{token}. Затем раскройте метод, нажмите Try it out, заполните параметры и нажмите Execute.

Какая версия Bot API описана в спецификации?

Bot API 10.3 от 24 августа 2026 года: 185 методов в 19 группах, включая rich-сообщения и эфемерные сообщения.

Чем Swagger отличается от Bot API Tester?

Swagger удобен как справочник: структура API, параметры с типами, коды ответов и ссылки на официальную документацию. Bot API Tester заточен под практику: формы параметров, long polling для getUpdates и история апдейтов.

Куда уходит мой токен бота?

Только в запросы к api.telegram.org, которые отправляет ваш браузер. Своего сервера у страницы нет, поэтому токен не проходит через посредников.