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: line | Get content с message.id | Webhook содержит метаданные, а не бинарный файл |
Изображение, видео или аудио с contentProvider.type: external | contentProvider.originalContentUrl | Get content не может скачать этот внешний файл |
| Сообщение с файлом | Get content с ID сообщения | Сохраняйте метаданные файла; не предполагается, что у всех сообщений есть contentProvider |
| Текст | Сохранить текст из webhook | API для повторного получения этого текста позже нет |
Последние две строки особенно важны для общего входящего обработчика. Не отклоняйте файл из-за отсутствия поля 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 доказывает только наличие идентификатора, а не будущую доступность файла.
Рекомендуемый порядок обработки:
- Проверьте подлинность события и надёжно сохраните его вместе с контекстом канала и сообщения.
- Создайте восстанавливаемую задачу загрузки одновременно с записью приёма. В руководстве по пакетам LINE webhook объясняется, почему нельзя подтверждать запрос, сохранив лишь часть событий.
- Скачайте оригинал через нужную ветку источника. До передачи оператору или AI-инструменту примените ограничения размера, тайм-ауты и проверку содержимого.
- Сохраните ссылку на собственное хранилище и ограничьте доступ правами на беседу. Имена файлов и заявленные типы медиа считайте недоверенными входными данными.
- Если загрузка не завершилась, явно покажите недоступность вложения и при необходимости запросите разрешённую повторную отправку.
При работе с внешними 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:
Превратите интеграцию сообщений в стабильный продуктовый pipeline.
Начните с отправки через единый API, затем возвращайте входящие сообщения в бизнес-систему стандартными событиями.