API

Ми пропонуємо два види API для розробників. Bot API дозволяє легко створювати програми, які використовують повідомлення Telegram для інтерфейсу. Telegram API дозволяє створювати свої власні індивідуальні клієнти Telegram. Ви можете використовувати обидва API, безкоштовно.


Bot API

Цей API дозволяє підключати ботів до нашої системи. Боти Telegram — це спеціальні акаунти, які не вимагають додаткового номера телефону для налаштуваня. Ці акаунти служать інтерфейсом для коду, який виконується десь на вашому сервері.

Для того, щоб скористатися цією функцією, вам не потрібно нічого знати про те, як працює наш протокол шифрування MTProto — наш сервер-посередник буде обробляти всі шифрування і зв’язок з API Telegram для вас. Ви спілкуєтеся з цим сервером через простий HTTPS-інтерфейс, який пропонує спрощену версію API Telegram.

Дізнайтеся більше про Bot API тут »


Telegram API

Цей API дозволяє створювати свої власні індивідуальні клієнти Telegram. Це на 100% відкрито для всіх розробників, які хочуть створити програми Telegram на нашій платформі. Не соромтеся дослідити відкритий вихідний код уже створених програм Telegram для прикладів того, як усе тут працює. Не забудьте зареєструвати свою програму в нашій системі.

Опис протоколу клієнтів Telegram – MTProto – ви можете знайти тут »

Початок роботи

Створення програми

Як отримати ідентифікатор програми і створити нову програму Telegram.

Авторизація користувача

Як зареєструвати телефон користувача для початку використання API.

Обробка помилок

Як правильно обробляти повернуті API помилки.

Робота з різними дата-центрами

Як підключитися до найближчої точки доступу дата-центру для швидшої взаємодії з API і на що потрібно звернути увагу при розробці клієнта.

Обробка оновлень

Як підписатися на оновлення та обробку вхідних повідомлень.

Обробка PUSH-сповіщень

Як підписатися на оновлення і обробляти вхідні сповіщення.

Виклик методів

Додаткові опції для викликання методів.

Передача і завантаження файлів

Як правильно передавати великі пакети даних.

Безпека

Секретні чати, наскрізне шифрування

Нова особливість для наскрізного шифрування повідомлень.

Дотримання вимог безпеки

Важливі перевірки, які потрібні в клієнтській програмі.

Ідеальна пряма безпека

Постійна прив’язка до тимчасового ключа авторизації.

Оптимізація

Оптимізація клієнта

Шляхи покращення взаємодії з API.

Методи API

Список доступних методів

Повний список доступних методів високого рівня.

TL-схеми API, в форматі JSON

Текст і JSON-уявлення типів і методів, використовуваних у API.

Список доступних рівнів

Повний список доступних версій схеми.

Журнал оновлень

29 жов, 2014 Реорганізовано документацію секретних чатів: до окремого документу переміщено обробку порядкових номерів, додано розділ у шарах оновлення секретних чатів.
9 жов, 2014 Додано Шар 18.
26 вер, 2014 Додано Шар 17.
29 сер, 2014 Нова стаття про ідеальну пряму секретність. дано Шар 15 та Шар 16.
4 кві, 2014 Додано Шар 13 та Шар 14.
15 бер, 2014 Додано Шар 12.
21 гру, 2013 Додано Шар 11.
30 лис, 2013 Додано Шар 10.
30 жов, 2013 Додано Шар 9.
8 жов, 2013 Нова стаття про секретні чати. Додано Шар 8.
6 вер, 2013 Нова стаття про шари TL-схеми, геочати, нові запити. Додано рівні 2-4.
27 сер, 2013 Нова стаття про оптимізація клієнтів.
3 сер, 2013 Оновлення для документів про поліморфізм та вектори у TL. Тепер універсальні вектори використовуються у всіх випадках, вилучено застарілу мову у шаблонах.
2 серп, 2013 Додано конструктор оновлення updateMessageID.
1 серп, 2013 Опис для спільних оновлень, додано конструктор updatesCombined
31 лип, 2013 Опис для логіки завантаження/вивантаження файлу
29 лип, 2013 Опис для логіки використання gzip-стиснення для клієнтів
28 лип, 2013 Нова стаття про механізм тестування для пересилання поміж дата-центрами