Telegram
Все запросы следует выполнять методом POST по адресу:
https://cloud.controller.touch-api.com/api/{METHOD_NAME}
Тело передавать в JSON, ответ также будет JSON-объект.
Тело запроса обязательно должно содержать поле:
Если в ответе есть поле "error", значит произошла какая то ошибка, и в этом поле содержится ее текстовое описание. Так же будет возвращен uuid, который необходимо указать при обращении в техническую поддежку.
Подключение аккаунта
/addAccount - добавление аккаунта в систему. (Логином должен быть номер телефона)
/setState - запуск аккаунта
В случае, если логин был указан неверно, метод вернет ошибку:
Возможные проблемы
В момент первого запуска или после смены прокси возможны следующие ошибки:
1. В случае ошибки "Challenge required" - код придет в телеграм или смс, и с полученным кодом следует вызвать метод /solveChallenge
2. Если включена двухфакторная аутентификация (2FA), метод вернёт ошибку "Two factor auth required". С полученным в SMS кодом следует вызвать метод /twoFactorAuth
Добавить аккаунт
Добавить новый телеграм аккаунт
POST
https://cloud.controller.touch-api.com/api/addAccount
Метод для подключения нового телеграм аккаунта
Request Body
token*
string
Токен для аутентификации
login*
string
Ваш телеграм логин
proxyString*
string
socks5://proxyUsername:proxyPassword@proxyIP:proxyPort
webhookUrl
string
Обновить аккаунт
POST
https://cloud.controller.touch-api.com/api/updateAccount
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
proxyString
String
socks5://proxyUsername:proxyPassword@proxyIP:proxyPort
webhookUrl
String
Удалить аккаунт
POST
https://cloud.controller.touch-api.com/api/deleteAccount
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
Изменить состояние (запуск/остановка)
POST
https://cloud.controller.touch-api.com/api/setState
Если сервер не отвечает после setState, возможно есть проблема с вашим прокси. Пожалуйста, обратитесь для проверки в техническую поддержку
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
setState*
boolean
запуск/остановка аккаунта
qrLogin
boolean
для авторизации по QR коду необходимо задать значение true
Получить информацию о подключенном аккаунте
POST
https://cloud.controller.touch-api.com/api/getMe
Получение информации о подключенном аккаунте. Может быть актуально в случае куар авторизации.
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
Принудительная остановка
POST
https://cloud.controller.touch-api.com/api/forceStop
Метод принудительной остановки аккаунта может быть полезен в случае, если были ошибки во время запуска или setState:false выполняется с ошибкой
Request Body
token
String
login
String
Получить ссылку на QR код
POST
https://cloud.controller.touch-api.com/api/getQr
Если аккаунт находится в степе 2.2, то это актуальная ссылка. Если в степе 2.3, то ссылка не актуальна - нужно перезапускать
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
Очистка
POST
https://cloud.controller.touch-api.com/api/clearSession
Метод используется для очистки данныйх сессии. Перед очисткой необходимо остановить аккаунт, после успешной очистки запустить аккаунт.
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
2FA авторизация
POST
https://cloud.controller.touch-api.com/api/twoFactorAuth
Request Body
token*
String
Токен для аутентификации
code*
String
Код для 2FA
login*
String
Номер телефона
Авторизация по коду из смс/лс телеграма
POST
https://cloud.controller.touch-api.com/api/solveChallenge
Request Body
token*
String
Токен для аутентификации
code*
String
Код из сообщения
login*
String
Номер телефона
Получить информацию о контакте
POST
https://cloud.controller.touch-api.com/api/getUserInfo
По умолчанию выставлены лимиты в 15 новых контактов в день + 200 новых контактов за все время.
Request Body
token*
String
Токен для аутентификации
login*
String
Номер телефона
to*
String
тел. номер/user_id/username
allowContactCreation*
boolean
Создать контакт, если он отсутствует
Отправить сообщение
POST
https://cloud.controller.touch-api.com/api/sendMessage
Request Body
token*
String
Токен для аутентификации
msg*
object
Поля объекта описаны ниже
login*
String
Номер телефона
Таблица состояний аккаунта
Account just started to start
0
This account needs 2FA solving,
API Docs 2.1
2.1
QR code received
2.2
This account needs challenge solving,
API Docs 2.2
2.25
Can not update QR
2.3
Another error during account launch
2.5
Account started successfully &
realtime init done
5
Возможные content (в хуках, /sendMessage
и /getChatMessages
)
/sendMessage
и /getChatMessages
)image
image url
отправка / прием картинок
video
video url
отправка / прием видео
link
<description>&url=<url>
отправка / прием
ссылки с текстом
audio
audio url
отправка / прием аудио
has_seen
*пустая строка*
статус сообщения “прочитано”
file
file url
отправка / прием файлов
* file используется в случае когда не удалось распознать картинку, видео или аудио
** красным выделено то, что еще не добавлено в апи
Last updated