Практика работы с Telegram
Экспорт аккаунта: JSON, Session+JSON и TData
Как сохранить подключённый Telegram-аккаунт через API Telecobra, выбрать формат и проверить перенос. Импорт и экспорт — отдельные операции.
Выберите формат результата#
| Параметр format | Что возвращается | Назначение |
|---|---|---|
| json | JSON-ответ с объектом account | Описание аккаунта и строковая сессия |
| session | ZIP: файл .session и одноимённый .json | Передача в инструмент, поддерживающий сессии Telethon |
| tdata | ZIP с каталогом tdata/ | Данные для совместимого Telegram Desktop |
Экспорт относится к аккаунту, который уже подключён к вашему кабинету. Укажите его внутренний ID Telecobra, а не Telegram ID пользователя и не номер телефона. Тариф должен давать доступ к API. Способ получения ключа описан в инструкции по API.
Запрос и сохранение файла#
Ниже шаблон GET-запроса для своего аккаунта. Замените ACCOUNT_ID и передайте свой API-ключ в заголовке X-API-Key. Сам ключ не добавляют в адрес страницы.
GET https://telecobra.com/api/accounts/ACCOUNT_ID/export?format=session
X-API-Key: <ваш ключ Telecobra>- Получите список своих аккаунтов через GET /api/accounts и сопоставьте запись с нужным телефоном или username.
- В HTTP-клиенте задайте заголовок авторизации и формат. Для Session или TData включите сохранение ответа в файл.
- Сначала проверьте код HTTP и тип ответа. JSON с сообщением об ошибке не является ZIP, даже если сохранён с расширением .zip.
- Откройте архив локально. Для Session проверьте наличие пары с одинаковым базовым именем; для TData — вложенного каталога.
- Остановите работу с этим аккаунтом в старом инструменте на время проверки переноса. Подключите копию в выбранном совместимом клиенте и сверьте аккаунт.
TData → Session+JSON и обратное направление#
Для TData → Session+JSON сначала выполните импорт TData в Telecobra, затем экспортируйте добавленную запись с format=session. Для Session → TData импортируйте поддерживаемую Session, проверьте подключение и запросите format=tdata. Это последовательность двух операций, а не переименование файлов.
Экспорт TData требует действующей авторизации и доступного соединения аккаунта. Ошибка сборки архива требует проверки исходной сессии и прокси. Нельзя гарантировать обработку любого архива сторонней программы, особенно защищённого локальным кодом.
Что находится в JSON#
Описание включает поля телефона, username, API ID/Hash, параметров устройства, статуса, времени добавления, прокси и session_string. Часть сведений уточняется через подключение к Telegram; если оно не удалось, отдельные поля могут остаться пустыми. Поле twoFA в этом экспорте не восстанавливает пароль и возвращается без его значения.
Файл содержит данные доступа. Храните его как резервную копию, не прикладывайте к публичным задачам и не отправляйте в онлайн-конвертеры неизвестного происхождения. Для обращения в поддержку достаточно названия формата и текста ошибки без сессии и ключей.
Совместимость и несколько аккаунтов#
Расширение .session не определяет библиотеку: файл Telethon и файл другого клиента могут иметь разные схемы. Конвертация между Telethon, Pyrogram и TDLib требует поддержки конкретной пары форматов. Экспорт Telecobra не является универсальным конвертером всех библиотек.
Для нескольких аккаунтов ведите соответствие «ID Telecobra → исходный файл → экспорт». Не соединяйте части разных TData в одну папку. Дубликат сессии относится к тому же аккаунту и не создаёт нового пользователя Telegram.
Источники и документация#
Одна платформа · разные задачи
Подписка Telecobra
Соберите инструменты для работы с Telegram в одном кабинете. Сроки доступа, цены и условия — на странице подписки.
В этой инструкции описана только часть возможностей платформы. Полный список доступен в разделе функций.
