Как устроен API
API даёт вашим программам те же действия, что делают аккаунты в кабинете: найти чаты, собрать участников, проверить профиль, написать человеку, сменить имя. Доступ — по ключу с выбранными правами.
Ранний доступ
API сейчас в раннем доступе: чтобы включить его, напишите в поддержку — кнопка Написать в поддержку есть прямо в разделе. Раздел открывается из меню профиля справа вверху: API.
Как проходит вызов
- КлючСоздать с нужными правами
- ВызовМетод и аккаунт, от чьего имени
- ЗадачаВ ответ — номер задачи
- РезультатЗабрать по номеру задачи
Методы работают не мгновенно: действие выполняет аккаунт в Telegram, поэтому вызов сразу возвращает номер задачи, а результат вы забираете опросом. Подробно — «Вызвать метод».
Документация в кабинете
Вкладка Документация в разделе API — живой справочник: все методы с параметрами и ограничениями, суточные лимиты на аккаунт, пример результата и права ключа. Она всегда совпадает с тем, что принимает API.
Ограничения
- Каждый метод работает от имени одного вашего аккаунта и тратит его суточный лимит на это действие — тот же, что и при работе в кабинете.
- Не больше 60 запросов в минуту.
- Не больше 15 действующих ключей.