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

LINE Get Content: ответ 202 и загрузка внешних медиафайлов

Webhook с медиасообщением LINE — это ещё не сам файл. Для изображений, видео и аудио проверьте message.contentProvider.type: при line используется официальный Get content, при external — переданный URL исходного контента. Ответ 202 во время подготовки видео или аудио не означает завершение загрузки. LINE не гарантирует срок хранения пользовательского контента, поэтому сохраняйте разрешённые к обработке файлы своевременно: ID сообщения не заменяет постоянный архив.

Главное

  • Выбирайте способ загрузки по источнику контента, а не только по типу медиа.
  • Get content использует api-data.line.me, а не привычный api.line.me.
  • Приём webhook, готовность медиа и успешное сохранение — разные состояния.
  • Превью не равно оригиналу. Смена интеграции не восстанавливает удалённый контент.

Сначала определите источник медиа LINE

Справочник LINE Messaging API различает контент LINE и внешние источники в объектах изображений, видео и аудио.

Полученный контентСпособ полученияВажное ограничение
Изображение, видео или аудио с contentProvider.type: lineGet content с message.idWebhook содержит метаданные, а не бинарный файл
Изображение, видео или аудио с contentProvider.type: externalcontentProvider.originalContentUrlGet content не может скачать этот внешний файл
Сообщение с файломGet content с ID сообщенияСохраняйте метаданные файла; не предполагается, что у всех сообщений есть contentProvider
ТекстСохранить текст из webhookAPI для повторного получения этого текста позже нет

Последние две строки особенно важны для общего входящего обработчика. Не отклоняйте файл из-за отсутствия поля contentProvider, которое требуется вашей ветке обработки изображений. Не передавайте ID текстового сообщения в операцию загрузки бинарных данных.

Для контента LINE документирован запрос GET /v2/bot/message/{messageId}/content на домене api-data.line.me с авторизацией через channel access token. Храните токен только на сервере. Используйте ID сообщения из проверенного события соответствующего канала, а не ID пользователя, reply token или ID события.

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

Разберите ответ перед повторной попыткой

Согласно описанию Get content, успешный ответ 200 содержит бинарные данные, формат которых указан в заголовке Content-Type. Большие видео- и аудиофайлы могут ещё готовиться: в этом случае возвращается 202.

НаблюдениеРекомендуемое действие
200 с бинарными даннымиПотоково записать файл в контролируемое хранилище, проверить его и отметить завершение только после успешного сохранения
202 при получении видео или аудиоОставить задачу ожидающей; проверить подготовку перед следующей загрузкой
404 или 410Проверить ID сообщения, привязку к каналу, источник и ошибку; бесконечные повторы не гарантируют восстановление
Внешний URL не работаетПроверить внешний сервер и доступность URL; контентный API LINE не является запасным способом скачивания
Миниатюра есть, оригинала нетОтслеживать их отдельно и не считать вложение полностью сохранённым

Проверка подготовки выполняется через GET /v2/bot/message/{messageId}/content/transcoding, описанный в справочнике API. Соблюдайте собственный контракт домена и ответа этого метода: нельзя переносить домен бинарной загрузки на все запросы.

Задайте ограниченный график опроса и бюджет повторных попыток на стороне приложения. Это эксплуатационная рекомендация, а не гарантия времени подготовки от LINE. Не считайте любой HTTP-ответ успешного класса готовым файлом и не отправляйте ответ о подготовке в декодер изображений или сервис транскрибации.

Сохраняйте вовремя и учитывайте отмену отправки

LINE указывает, что контент автоматически удаляется через некоторое время, но не гарантирует продолжительность хранения. Сохранённый ID доказывает только наличие идентификатора, а не будущую доступность файла.

Рекомендуемый порядок обработки:

  1. Проверьте подлинность события и надёжно сохраните его вместе с контекстом канала и сообщения.
  2. Создайте восстанавливаемую задачу загрузки одновременно с записью приёма. В руководстве по пакетам LINE webhook объясняется, почему нельзя подтверждать запрос, сохранив лишь часть событий.
  3. Скачайте оригинал через нужную ветку источника. До передачи оператору или AI-инструменту примените ограничения размера, тайм-ауты и проверку содержимого.
  4. Сохраните ссылку на собственное хранилище и ограничьте доступ правами на беседу. Имена файлов и заявленные типы медиа считайте недоверенными входными данными.
  5. Если загрузка не завершилась, явно покажите недоступность вложения и при необходимости запросите разрешённую повторную отправку.

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

Сохранение создаёт обязанность удалять копии. Используйте схему очистки после LINE unsend и повторно проверяйте признак удаления перед публикацией результата загрузки. Задача, завершившаяся после отмены отправки, не должна возвращать вложение во входящие.

Отделяйте контракт вложений UnifyPort

Неофициальный интерфейс UnifyPort передаёт нормализованное событие message.received, а не нативный объект сообщения LINE. Медиа находятся в data.message.attachments[]; справочник стандартных событий описывает временные подписанные OSS URL, типы вложений и метаданные.

Не передавайте нормализованный ID сообщения в LINE Get content и не ожидайте наличия contentProvider. Обрабатывайте полученный URL вложения в соответствии с политикой хранения. Если URL отсутствует, зафиксируйте ограничение, а не создавайте адрес самостоятельно. Публичный справочник не описывает метод обновления URL вложения и не гарантирует повторную передачу пропущенных сообщений.

Для этого отдельного приёмника задайте signing_secret и следуйте контракту доставки webhook: проверяйте HMAC-SHA256 по исходным байтам тела и надёжно сохраняйте принятое событие. Корректная подпись подтверждает доставку, но не доказывает, что файл ещё доступен или безопасен для обработки.

Если требуется идентичность LINE Official Account и его нативный контракт контента, оставьте официальный Messaging API. UnifyPort не является сервисом восстановления недоступных вложений Official Account.

Вопросы и ответы

Означает ли 202 успешную загрузку файла LINE?

Нет. Пока видео или аудио готовится, запрос может вернуть 202 без бинарных данных. Проверьте подготовку и скачайте файл позже в рамках своей политики повторов.

Может ли Get content скачать внешнее изображение?

Нет. При contentProvider.type: external используйте contentProvider.originalContentUrl и собственные средства безопасной загрузки.

Сколько дней LINE хранит контент?

Срок не гарантирован. Не обещайте пользователям восстановление в течение фиксированного числа дней.

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

Проверьте изображение LINE, внешний файл, подготовку видео или аудио, недоступный контент и отмену отправки во время загрузки. Это предлагаемые проверки, а не результаты проведённых тестов. Для нормализованного приёма начните со справочника message.received.

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

UnifyPort API

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

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