Что такое…

Что такое диплинк — и почему право открыть ссылку в приложении даёт файл на твоём сайте

Иллюстрация: ключ подходит к двери только после проверки бумаги на стене дома

Неожиданная штука: разрешение открывать ссылку в твоём приложении выдаёт не приложение и не магазин. Его выдаёт файл, который лежит у тебя на сайте.

Телефон сам ходит на твой домен, читает оттуда табличку и только после этого соглашается: да, вот эта ссылка принадлежит вот этому приложению. Разберёмся, зачем такая странность.

Диплинк — это ссылка вглубь

Обычная ссылка на приложение открывает его на главном экране. Диплинк (deep link, «глубокая ссылка») ведёт в конкретное место: на товар, на чат, на нужный урок.

Это то самое, что происходит, когда друг кидает тебе ссылку на видео — и оно открывается в приложении, а не в браузере.

Видов ровно два, и путать их дорого.

Вид первый: схема myapp:// — это не ссылка, а имя

Выглядит как ссылка: myapp://lesson/12. По сути — просто позывной. Приложение при установке говорит системе: «если увидишь myapp://, зови меня».

Отсюда две проблемы.

Если приложения нет — не произойдёт ничего. Не ошибка 404, не предложение установить, а тишина или невнятное системное окно. Человек, который открыл твою ссылку без приложения, просто упирается в пустоту.

Имя может занять кто угодно. Никто не проверяет, что myapp:// — твоё. Другое приложение объявляет ту же схему, и дальше кому повезёт. Поэтому на схему нельзя вешать ничего чувствительного: коды входа, токены, возврат после оплаты.

Схемы удобны для внутренних переходов и до сих пор живут в OAuth-возвратах. Но как публичная ссылка они плохи.

Вид второй: обычный https, который умеет открывать приложение

Второй вид называется универсальными ссылками (Universal Links на iOS) и ссылками приложения (App Links на Android). Выглядит он как самая обычная ссылка на сайт: https://твойпроект.ru/lesson/12.

Фокус в том, что она работает всегда:

  • приложение установлено — открывается приложение, сразу на нужном экране;
  • не установлено — открывается веб-страница по тому же адресу.

Никакой тишины и никакого тупика. Одна ссылка на все случаи.

Как телефон понимает, что ссылка твоя

Вот тут и появляется файл на сайте.

На Android система при установке приложения идёт по адресу https://твойдомен/.well-known/assetlinks.json и проверяет, указано ли в нём это приложение. Проверка включается атрибутом android:autoVerify="true" в манифесте. На iOS то же самое, только файл называется apple-app-site-association и лежит в той же папке .well-known.

Требования жёсткие и одинаково скучные для обеих платформ:

  • только по HTTPS;
  • без редиректов — файл должен отдаваться прямо по этому адресу;
  • отдаваться как JSON (у файла iOS при этом вообще нет расширения);
  • домен должен быть твой — тот, что ты купил и подключил.

Логика красивая: контроль над доменом и есть доказательство. Чужое приложение не может объявить твои ссылки своими, потому что не сможет положить файл на твой сайт.

Ценой за это стала знаменитая боль: если файл недоступен или отдаётся с редиректом, ссылка молча открывается в браузере, и никакой ошибки ты не увидишь. Что с этим делать — в статье почему диплинк не открывает приложение.

Где ты это встретишь

Раньше, чем соберёшь своё приложение. Диплинки нужны для писем («подтвердить почту»), для приглашений в приложение, для возврата после оплаты, для уведомлений (нажал — попал на нужный экран, а не на главную).

Если ты пока делаешь только сайт — тебя это тоже касается: файл-то живёт на сайте. Вопрос приложение или сайт решается отдельно, а вот ссылки связывают их в обе стороны.

Что забрать с собой

Три вещи, которые сэкономят тебе вечер отладки.

Первое. Строй публичные ссылки на своём домене, а не на схеме. Схема — для внутренних переходов, https-ссылка — для всего, что уходит наружу: письма, приглашения, уведомления, посты.

Второе. Веб-страница по этому адресу должна существовать и быть осмысленной. Она сработает всегда: у человека без приложения, в чужом браузере, у поисковика. Приложение — приятный бонус поверх неё, а не единственный сценарий.

Третье. Файл на домене — часть релиза, а не «настроим потом». Он должен приехать на сайт до того, как ты разошлёшь первые ссылки: телефон запоминает результат проверки, и переубедить его сложнее, чем сделать сразу.

Диплинк и универсальная ссылка — это одно и то же?

Не совсем. Диплинк — общее название для ссылки, ведущей вглубь приложения. Универсальная ссылка — конкретный современный способ её сделать, через обычный https-адрес и проверку домена.

Почему после правки файла ничего не изменилось?

Обе платформы кэшируют результат проверки. На iOS файл забирается через CDN Apple, а не напрямую с твоего сервера, так что свежая правка расходится не мгновенно. На Android проверка выполняется при установке — иногда приложение проще переустановить, чем ждать.

Работают ли диплинки внутри мессенджеров?

Не всегда. Встроенные браузеры некоторых приложений открывают ссылку у себя внутри и не отдают её системе. Поэтому веб-страница по тому же адресу обязана быть рабочей и осмысленной — она твой запасной вариант по умолчанию.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →