Отмена авторизации UnifyPort без повторного показа старого QR-кода
Чтобы отменить авторизацию в UnifyPort, отправьте POST /v1/accounts/{account_id}/auth/cancel с телом {} для поддерживаемого провайдера. Закрытие окна с QR-кодом меняет только интерфейс приложения. Скройте прежние данные входа, не позволяйте запоздалым ответам восстановить их, отправьте отмену и прочитайте состояние авторизации перед новым входом. Тайм-аут означает неопределённый результат, а не доказанную неудачу отмены.
Главное
- Документированная поддержка отмены охватывает Telegram, WhatsApp и TikTok. Поддержка QR-входа сама по себе ничего не говорит о поддержке отмены.
- Ответ операции
cancelledи текущее состояние авторизации аккаунта — разные наблюдения. - Согласовывайте запуск, отмену и отправку учётных данных на уровне аккаунта, в том числе между вкладками.
- Отмена авторизации не означает удаление аккаунта, изменение оплаты или отзыв всех сессий в нативном приложении.
Выберите действие по намерению пользователя
| Намерение | Подходящее действие |
|---|---|
| Временно скрыть экран входа | Закрыть интерфейс и явно определить, продолжается ли авторизация |
| Отказаться от текущей попытки входа | Вызвать поддерживаемую операцию отмены |
| Приостановить действующее соединение | Остановить runtime, а не сбрасывать авторизацию |
| Удалить ресурс аккаунта из UnifyPort | Выполнить отдельную процедуру удаления аккаунта |
Руководство по плановой остановке runtime относится к уже подключённому аккаунту. Здесь рассматривается попытка авторизации, которую оператор больше не хочет завершать.
Справочник Cancel authentication описывает отмену входа по коду, QR и через импорт сессии, но список поддерживаемых провайдеров ограничен Telegram, WhatsApp и TikTok. Наличие QR-входа у LINE и Zalo не означает, что эта операция применима к ним.
Истечение QR-кода и отмена попытки — разные события
Официальная спецификация Telegram описывает срок действия токена входа, создание нового QR-кода и подтверждение через уже авторизованное приложение. Поэтому старое изображение QR нельзя считать постоянным состоянием входа. Однако спецификация не определяет контракт отмены UnifyPort и не гарантирует, что закрытие окна браузера остановит авторизацию.
В UnifyPort получение состояния авторизации возвращает status, auth_fields, auth_payload, expires_at и last_error. Используйте актуальное состояние и данные, а не сохранённый снимок экрана. Не отправляйте QR-коды, коды подтверждения, пароли и материалы сессий в журналы или аналитику.
Для первого подключения используйте руководство по входу в Telegram через код и QR. Здесь добавляется другой контроль: какая именно попытка ещё вправе менять экран и отправлять запросы.
Выполняйте действия авторизации последовательно
Следующая схема — рекомендация по архитектуре приложения, а не гарантия серверной транзакции:
- Привяжите экран к проверенным workspace и
account_id. Убедитесь, что оператор вправе управлять выбранным аккаунтом обмена сообщениями. - Поддерживайте один действующий контроллер авторизации на аккаунт в backend. Согласовывайте действия других вкладок и операторов, а не только повторное нажатие одной кнопки.
- При отмене сделайте локальную попытку неактивной, скройте секретные данные, отключите отправку кода и пароля, прекратите планирование новых опросов.
- Измените поколение локального интерфейса, чтобы уже отправленные запросы не могли вернуть старый экран.
- Отправьте отмену через backend. Не разрешайте новый запуск до проверки результата.
Этот пример для браузера отбрасывает устаревшие ответы чтения. generation и loginVisible — переменные приложения, а не поля UnifyPort:
let generation = 0;
let loginVisible = true;
async function refreshLogin(readAuth, render) {
const observedGeneration = generation;
const auth = await readAuth();
if (!loginVisible || observedGeneration !== generation) return;
render(auth);
}
function abandonLocalAttempt(clearSensitiveUi) {
loginVisible = false;
generation += 1;
clearSensitiveUi();
}
Такая защита не отменяет уже отправленный HTTP-запрос, не отзывает подтверждение у провайдера и не останавливает другую вкладку. Координация backend и чтение состояния остаются необходимыми. Приёмник webhook должен продолжать работать: запоздалое событие авторизации должно инициировать сверку состояния, а не автоматически открывать прежнее окно QR.
Отправьте отмену и проверьте текущее состояние
Ниже приведены примеры запросов, которые здесь не выполнялись. Значения переменных должны поступать из защищённой конфигурации backend и проверенного выбора аккаунта:
curl -X POST \
"https://api.unifyport.ai/v1/accounts/${ACCOUNT_ID}/auth/cancel" \
-H "X-Api-Key: ${UNIFYPORT_API_KEY}" \
-H "Content-Type: application/json" \
-d '{}'
curl \
"https://api.unifyport.ai/v1/accounts/${ACCOUNT_ID}/auth" \
-H "X-Api-Key: ${UNIFYPORT_API_KEY}"
Справочник отмены показывает HTTP 200 с data.status: "cancelled". В описании жизненного цикла аккаунта отказ от ожидающего ввода процесса описан как переход в pending_auth. Не копируйте результат операции во все поля состояния аккаунта.
| Наблюдение | Рекомендуемое действие |
|---|---|
Отмена подтверждена, состояние — pending_auth | Оставить старые данные скрытыми; предложить осознанный новый запуск |
| Тайм-аут или нечитаемый ответ | Отметить результат как неподтверждённый и прочитать состояние перед следующей изменяющей операцией |
| По-прежнему ожидается ввод | Не восстанавливать прежний экран; сверить состояние или передать вопрос ответственному, не запускать конкурирующий процесс |
Состояние — authorized | Считать это текущим свидетельством авторизации; не показывать «выход выполнен» и не отменять повторно автоматически |
Если подтверждение и отмена происходят одновременно, публичный контракт не гарантирует, какое действие атомарно получит приоритет. Сохраните диагностические данные без секретов и дайте оператору принять решение по наблюдаемому состоянию. Не обещайте webhook об отмене, которого нет в документации.
Новый запуск требует нового решения
Документация жизненного цикла указывает, что запуск авторизации по коду, QR или сессии для уже авторизованного аккаунта возвращает 409 account_already_authorized. Это не разрешение автоматически отменить исправный аккаунт и повторить вход. Сначала выясните, действительно ли нужна новая авторизация.
Для прерванной ожидающей попытки сначала проверьте результат отмены, затем создайте новое поколение UI и вызовите документированный запуск для настроенного режима аккаунта. Показывайте только вновь полученные данные. После авторизации отдельно прочитайте runtime_status, прежде чем считать соединение готовым.
UnifyPort предоставляет неофициальный интерфейс. Операция отмены не является универсальным выходом из всех сессий провайдера и не отменяет его меры безопасности.
Вопросы и ответы
Закрытие окна QR отменяет авторизацию?
Само по себе — нет. Оно меняет интерфейс приложения. Для отмены на сервере нужна поддерживаемая операция API.
Нужно автоматически отменять вход после истечения QR-кода?
Нет. Срок действия относится к отображаемым данным входа. Прочитайте актуальное состояние и следуйте процедуре обновления провайдера, если пользователь не решил отказаться от попытки.
Можно показать успешную отмену после тайм-аута?
Нет. Покажите неподтверждённый результат и сверьте состояние. Не начинайте новую авторизацию сразу и не отправляйте отмену многократно.
Отмена прекращает оплату или удаляет сообщения?
Контракт отмены этого не устанавливает. Завершение использования аккаунта, оплату, очистку сохранённых сообщений и авторизацию следует обрабатывать отдельно.
Следующий шаг и источники
Реализуйте процесс по справочнику Cancel authentication. Проверьте запоздалые ответы опроса, две вкладки, одновременные подтверждение и отмену, потерянный ответ и намеренный новый запуск. Это предлагаемые проверки, а не результаты выполненных тестов.
Источники проверены 2026-11-12:
Превратите интеграцию сообщений в стабильный продуктовый pipeline.
Начните с отправки через единый API, затем возвращайте входящие сообщения в бизнес-систему стандартными событиями.