← Все статьи
Гайд

URI-действия LINE: лимит 10 000 символов и ссылки для ПК

URI-действия LINE Messaging API теперь допускают до 10 000 символов отдельно в uri и altUri.desktop. LINE объявила об изменении 27 октября 2026 года. Обновлять нужно проверки этих свойств, а не всех URL и текстовых полей. Во Flex Message настроенная альтернативная ссылка заменяет uri в LINE для macOS и Windows, но это не универсальная настройка для любого типа сообщения.

Главное

  • Новый предел относится к адресу URI-действия, а не к числу кнопок или всему сообщению.
  • Проверяйте строку, которую действительно отправляете: после сборки параметров и кодирования.
  • altUri.desktop применяется в поддерживаемых URI-действиях Flex Message, но не в quick reply.
  • Приём сообщения API, открытие страницы и завершение бизнес-операции требуют отдельных проверок.

Что именно изменила LINE

В официальном архиве новостей за 2026 год опубликовано изменение от 27 октября. Актуальный справочник URI-действий указывает предел 10 000 символов для обоих свойств.

СвойствоТекущий пределНазначение
uri10 000 символовURI, открываемый при выполнении действия
altUri.desktop10 000 символовАльтернативный URI для LINE на macOS и Windows там, где он поддерживается

LINE разрешает схемы http, https, line и tel и требует процентного кодирования URI с использованием UTF-8. Допустимая схема и длина не доказывают, что страница существует или доступна пользователю.

Не заменяйте все ограничения приложения числом 10 000. Для URL изображений, подписей, текста и контейнеров сообщений действуют отдельные спецификации. Если проблема в количестве вариантов, а не в длине адреса, воспользуйтесь обзором альтернатив кнопочному шаблону LINE.

Выберите адрес для каждого клиента

Справочник LINE поясняет: если задан altUri.desktop, LINE для macOS и Windows игнорирует uri и открывает альтернативный адрес. Свойство поддерживается в URI-действиях Flex Message и не работает в quick reply. В объявлении Flex Message также указан как формат, использующий это свойство для ПК; не распространяйте его на шаблонные сообщения или rich menu.

Ниже приведён пример объекта действия для Flex Message, а не полный запрос отправки:

{
  "type": "uri",
  "label": "Подробнее",
  "uri": "https://example.com/mobile/orders/42",
  "altUri": {
    "desktop": "https://example.com/orders/42"
  }
}

Адреса иллюстративные, это не работающие страницы заказов. Поместите действие в совместимый компонент и проверьте всё сообщение по справочнику LINE. Если задача — поделиться страницей MINI App, используйте руководство по пользовательской кнопке и постоянным ссылкам. Увеличение длины не заменяет правильное формирование ссылок MINI App.

Проверяйте итоговый URI, а не только поле редактора

Перед включением длинных адресов пройдите следующий список.

  1. Найдите все локальные ограничения. Проверьте редактор, серверную валидацию, сборщик сообщений и модели используемого SDK. Меняйте только проверки двух указанных свойств URI-действия. Проверьте установленную версию SDK, не предполагая, что все версии уже поддерживают новый предел.
  2. Сначала соберите, затем измерьте. Сформируйте адрес и параметры запроса, корректно применив процентное кодирование UTF-8. Проверяйте итоговое значение свойства, а не исходный текст или длину всего JSON. Не кодируйте URL целиком как одно значение параметра и не выполняйте повторное кодирование уже закодированных значений.
  3. Проверяйте оба адреса независимо. Корректная мобильная ссылка ничего не доказывает о ссылке для ПК. Страница для ПК должна работать вне исключительно мобильного сценария, отдельно обрабатывать вход и недоступные записи.
  4. Проверяйте права на целевой странице. В качестве меры безопасности приложения не помещайте в ссылки API-ключи, данные сессии и ненужные персональные сведения. Более длинное поле — не повод сериализовать всю карточку клиента в строку запроса. Предпочитайте ссылку на запись, доступ к которой проверяет сервер.
  5. Пройдите реальный пользовательский путь. Сначала убедитесь, что API принимает полное сообщение, затем нажмите действие в нужных мобильных и настольных клиентах. Проверьте конечную страницу после перенаправлений, а не только URL из сборщика.

В регрессионные проверки стоит включить значение ровно на границе и выше неё, закодированные параметры с символами вне ASCII, отдельно некорректный URI для ПК и страницу с обязательным входом. Это предлагаемые тесты, а не результаты выполненных проверок. Ответ на отправку сам по себе не подтверждает успех всего сценария.

Не смешивайте это с контрактом UnifyPort

Изменение относится к официальному LINE Messaging API. В матрице поддержки нормализованных сообщений UnifyPort не описаны отправка URI-действий LINE Flex Message и поле altUri.desktop. Не добавляйте его в запрос UnifyPort в расчёте на отображение нативной карточки.

Если нужны нативные интерактивные карточки LINE, используйте официальную интеграцию. Неофициальный интерфейс UnifyPort решает другую задачу: подключение обычного аккаунта LINE и обработку поддерживаемых диалогов через нормализованные события. Этот способ подключения описан в руководстве по авторизации LINE. Ни новый лимит URI, ни общий формат событий не меняют тип учётной записи и возможности выбранной интеграции.

Частые вопросы

URI-действия LINE всё ещё ограничены 1 000 символов?

Нет. Объявление от 27 октября 2026 года повысило предел; актуальный справочник указывает 10 000 символов для uri и altUri.desktop. Если длинные значения по-прежнему отклоняются, проверьте валидаторы приложения.

Работает ли altUri.desktop в quick reply?

Нет. LINE прямо указывает, что там свойство не работает. Используйте документированный контекст Flex Message и проверяйте соответствующий клиент для ПК.

Увеличилось ли число кнопок или объём разрешений MINI App на отправку?

Нет. Изменена только длина указанных свойств URI-действия. Ограничения компоновки, сценарии обмена, аутентификация и доступ к целевой странице остаются отдельными требованиями.

Следующий шаг и источники

Начните с проверки сборщика сообщений по справочнику URI-действий LINE. Если выбираете между нативными карточками и нормализованными сообщениями, сначала изучите матрицу поддержки UnifyPort, а затем реализуйте отправку.

Официальные источники проверены 2026-11-07:

UnifyPort API

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

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

Получить API KeyОткрыть справочник API