← Все статьи
Руководство

Отмена авторизации 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. Здесь добавляется другой контроль: какая именно попытка ещё вправе менять экран и отправлять запросы.

Выполняйте действия авторизации последовательно

Следующая схема — рекомендация по архитектуре приложения, а не гарантия серверной транзакции:

  1. Привяжите экран к проверенным workspace и account_id. Убедитесь, что оператор вправе управлять выбранным аккаунтом обмена сообщениями.
  2. Поддерживайте один действующий контроллер авторизации на аккаунт в backend. Согласовывайте действия других вкладок и операторов, а не только повторное нажатие одной кнопки.
  3. При отмене сделайте локальную попытку неактивной, скройте секретные данные, отключите отправку кода и пароля, прекратите планирование новых опросов.
  4. Измените поколение локального интерфейса, чтобы уже отправленные запросы не могли вернуть старый экран.
  5. Отправьте отмену через 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:

UnifyPort API

Превратите интеграцию сообщений в стабильный продуктовый pipeline.

Начните с отправки через единый API, затем возвращайте входящие сообщения в бизнес-систему стандартными событиями.