v10.5 194 методи
Головна Документація Тестер Mini App Зворотний зв’язок Замовити бота
UK

Документація Telegram Bot API — Swagger, OpenAPI 3.1

Telegram Bot API Swagger — інтерактивна документація Telegram Bot API у форматі OpenAPI 3.1: специфікація всіх 194 методів версії 10.5. Тут зручно вивчати API як довідник: методи згруповано за темами, кожен має параметри з типами, обов'язкові поля, коди відповідей і посилання на офіційну документацію. Запит можна виконати просто зі сторінки кнопкою Try it out.

Як користуватися

  1. Знайдіть метод в одній із 20 груп або відфільтруйте список за назвою групи в полі фільтра.
  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, яку можна скопіювати в термінал чи скрипт.

Що всередині специфікації

Методи розподілено на 20 груп: інформація про бота, оновлення, повідомлення, rich-повідомлення, ефемерні повідомлення, віджети, редагування, медіа, оплата, опитування, зворотні виклики, чат, адміністрування, форум, файли, стікери, ігри, історії, бізнес та інше. Окремі групи для rich- і ефемерних повідомлень та віджетів допомагають швидко знайти новинки Bot API 10.1–10.5: sendRichMessage, sendRichMessageDraft, editEphemeralMessageText, deleteEphemeralMessage, sendWidget та інші. Новий метод 10.5 setMySettings міститься в групі інформації про бота.

Коли знадобиться

Приватність

Сторінка не має власного сервера: запити Try it out надсилає ваш браузер напряму на api.telegram.org, токен більше нікуди не передається. Для експериментів зручніше окремий тестовий бот, а якщо токен потрапив у чужі руки, відкличте його командою /revoke в @BotFather.

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

Поширені запитання

Це офіційна документація Telegram?

Ні, це незалежний проєкт. Специфікацію OpenAPI 3.1 зібрано за офіційною документацією Bot API 10.5, а кожен метод має посилання на першоджерело на core.telegram.org.

Як виконати запит до Telegram Bot API зі Swagger?

Впишіть токен бота у змінну token у блоці Servers — вона підставляється в адресу https://api.telegram.org/bot{token}. Потім розгорніть метод, натисніть Try it out, заповніть параметри й натисніть Execute.

Яку версію Bot API описано в специфікації?

Bot API 10.5 від 22 листопада 2026 року: 194 методи у 20 групах, зокрема HTML-віджети, rich-повідомлення та ефемерні повідомлення.

Чим Swagger відрізняється від Bot API Tester?

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

Куди потрапляє мій токен бота?

Лише в запити до api.telegram.org, які надсилає ваш браузер. Власного сервера сторінка не має, тому токен не проходить через посередників.