← Tất cả bài viết
Cẩm nang

LINE Get Content: xử lý mã 202 và tải nội dung bên ngoài

Nhận webhook media từ LINE không có nghĩa là đã nhận được tệp. Với hình ảnh, video và âm thanh, hãy kiểm tra message.contentProvider.type: line dùng endpoint Get content chính thức; external dùng URL nội dung gốc được cung cấp trong sự kiện. Mã 202 khi video hoặc âm thanh đang được chuẩn bị không phải là tải xong. LINE không bảo đảm thời gian lưu nội dung người dùng gửi, vì vậy hãy sớm lưu nội dung bạn có quyền xử lý thay vì coi ID tin nhắn là kho lưu trữ vĩnh viễn.

Điểm chính

  • Chọn đường tải theo nguồn nội dung, không chỉ theo loại media.
  • Get content dùng api-data.line.me, không phải tên miền thường gặp api.line.me.
  • Tiếp nhận webhook, media sẵn sàng và lưu tệp thành công là ba trạng thái khác nhau.
  • Ảnh xem trước không phải bản gốc; đổi cách tích hợp không khôi phục được nội dung đã xóa.

Xác định nguồn tải media LINE trước

Tài liệu LINE Messaging API phân biệt nội dung do LINE lưu trữ và nội dung bên ngoài trong đối tượng tin nhắn hình ảnh, video và âm thanh.

Nội dung nhận đượcCách lấyRanh giới cần nhớ
Hình ảnh, video hoặc âm thanh có contentProvider.type: lineGọi Get content bằng message.idWebhook chứa siêu dữ liệu, không phải tệp nhị phân
Hình ảnh, video hoặc âm thanh có contentProvider.type: externalDùng contentProvider.originalContentUrlGet content không lấy được tệp bên ngoài này
Tin nhắn tệpGọi Get content bằng ID tin nhắnGiữ siêu dữ liệu của tệp; không giả định mọi tin nhắn đều có contentProvider
Văn bảnLưu văn bản trong webhookKhông có API để lấy lại văn bản đó về sau

Hai dòng cuối đặc biệt quan trọng với hộp thư dùng chung. Đừng từ chối tệp chỉ vì nó thiếu contentProvider mà nhánh xử lý hình ảnh yêu cầu. Cũng đừng đưa ID tin nhắn văn bản vào thao tác tải nhị phân.

Với media do LINE lưu trữ, yêu cầu được tài liệu hóa là GET /v2/bot/message/{messageId}/content trên api-data.line.me, xác thực bằng channel access token. Chỉ giữ token ở backend. Dùng ID tin nhắn từ sự kiện đã xác minh chữ ký và thuộc đúng channel, không phải ID người dùng, reply token hay ID sự kiện.

Hướng dẫn nhận tin nhắn cũng mô tả cách lấy ảnh xem trước cho hình ảnh và video. Ảnh này có thể phục vụ giao diện đang tải, nhưng không chứng minh tệp gốc đã được tải hoặc lưu.

Đọc kết quả trước khi thử lại

Theo tài liệu Get content, phản hồi 200 thành công trả về dữ liệu nhị phân, với định dạng trong header Content-Type. Video hoặc âm thanh lớn có thể vẫn đang được chuẩn bị và trả về 202.

Hiện tượngHành động đề xuất
200 kèm dữ liệu nhị phânGhi theo luồng vào kho lưu trữ có kiểm soát, kiểm tra nội dung và chỉ đánh dấu hoàn tất sau khi lưu thành công
202 khi lấy video hoặc âm thanhGiữ tác vụ chờ; kiểm tra trạng thái chuẩn bị trước lần tải tiếp theo
404 hoặc 410Kiểm tra ID tin nhắn, channel, nhánh nguồn và lỗi trả về; thử lại vô hạn không bảo đảm khôi phục
URL bên ngoài bị lỗiKiểm tra máy chủ bên ngoài và tính khả dụng của URL; content API của LINE không phải đường tải thay thế
Có ảnh thu nhỏ nhưng thiếu bản gốcTheo dõi riêng hai trạng thái, không đánh dấu tệp đính kèm đã được lưu đầy đủ

Endpoint kiểm tra chuẩn bị là GET /v2/bot/message/{messageId}/content/transcoding, được mô tả trong tài liệu API. Tuân theo tên miền và cấu trúc phản hồi riêng của endpoint này, không sao chép tên miền tải nhị phân sang mọi yêu cầu.

Nên đặt lịch polling và giới hạn số lần thử lại theo nhu cầu ứng dụng. Đây là khuyến nghị vận hành, không phải cam kết thời gian hoàn tất của LINE. Đừng coi mọi HTTP response thuộc nhóm thành công là tệp dùng được, hoặc chuyển phản hồi đang chuẩn bị cho bộ giải mã ảnh hay dịch vụ chuyển giọng nói thành văn bản.

Lưu sớm nhưng vẫn xử lý thu hồi tin nhắn

LINE cho biết nội dung sẽ tự động bị xóa sau một khoảng thời gian và không bảo đảm thời hạn lưu trữ. Lưu ID tin nhắn chỉ chứng minh bạn đã ghi lại định danh, không bảo đảm sẽ lấy được dữ liệu tệp trong tương lai.

Trình tự xử lý đề xuất:

  1. Xác minh nguồn và lưu bền vững sự kiện, kèm ngữ cảnh channel và tin nhắn.
  2. Tạo tác vụ tải media có thể tiếp tục xử lý cùng với bản ghi tiếp nhận. Hướng dẫn nhận nhiều sự kiện LINE webhook giải thích vì sao không nên xác nhận thành công khi mới lưu một phần yêu cầu.
  3. Tải bản gốc từ đúng nguồn. Áp dụng giới hạn dung lượng, thời gian chờ và kiểm tra nội dung trước khi giao cho nhân viên hoặc công cụ AI.
  4. Lưu tham chiếu đến kho lưu trữ do ứng dụng quản lý và kiểm soát truy cập theo cuộc hội thoại. Không mặc nhiên tin cậy tên tệp hoặc loại media được khai báo.
  5. Nếu không tải được, hiển thị rõ trạng thái tệp không khả dụng và đề nghị gửi lại khi phù hợp, trong phạm vi quyền được cấp.

Với URL bên ngoài, hãy kiểm tra đích và chuyển hướng, loại trừ đích thuộc mạng riêng, và tuyệt đối không chuyển LINE channel token sang máy chủ bên ngoài. Tránh ghi token hoặc chuỗi truy vấn của URL có chữ ký vào log chung. Đây là biện pháp đề xuất cho worker, không phải khẳng định LINE đã thực hiện thay bạn.

Lưu tệp cũng tạo ra trách nhiệm dọn bản sao. Làm theo quy trình xử lý LINE unsend và kiểm tra lại trạng thái xóa trước khi công bố kết quả tải. Tác vụ hoàn tất sau khi người dùng thu hồi không được đưa tệp trở lại hộp thư.

Tách riêng hợp đồng tệp đính kèm UnifyPort

Giao diện không chính thức của UnifyPort gửi sự kiện chuẩn hóa message.received, không phải đối tượng tin nhắn LINE gốc. Media nằm trong data.message.attachments[]; tài liệu sự kiện chuẩn mô tả URL OSS có chữ ký tạm thời, loại tệp đính kèm và siêu dữ liệu media.

Không đưa ID tin nhắn chuẩn hóa vào LINE Get content hoặc giả định có contentProvider. Xử lý URL tệp đính kèm được cung cấp theo chính sách lưu trữ. Nếu không có URL, ghi nhận giới hạn thay vì tự ghép địa chỉ. Tài liệu công khai không định nghĩa endpoint làm mới URL tệp đính kèm và không bảo đảm phát lại tin nhắn bị bỏ lỡ.

Với bộ nhận riêng này, đặt signing_secret và tuân theo hợp đồng phân phối webhook để xác minh HMAC-SHA256 trên body thô và lưu bền vững dữ liệu tiếp nhận. Chữ ký hợp lệ xác thực lần phân phối, không chứng minh tệp vẫn tải được hoặc an toàn để xử lý.

Nếu cần danh tính LINE Official Account và hợp đồng nội dung gốc, hãy tiếp tục dùng Messaging API chính thức. UnifyPort không phải dịch vụ khôi phục tệp đính kèm không còn khả dụng của Official Account.

Câu hỏi thường gặp

202 có nghĩa là tải tệp LINE thành công không?

Không. Khi video hoặc âm thanh đang được chuẩn bị, yêu cầu có thể trả 202 mà không có dữ liệu nhị phân. Kiểm tra trạng thái chuẩn bị rồi tải lại theo chính sách của ứng dụng.

Get content có tải được hình ảnh external không?

Không. Với contentProvider.type: external, dùng contentProvider.originalContentUrl cùng cơ chế tải an toàn của bạn.

LINE lưu nội dung trong bao nhiêu ngày?

LINE không bảo đảm thời gian. Đừng cam kết trên giao diện hỗ trợ rằng luôn khôi phục được trong một số ngày cố định.

Bước tiếp theo và nguồn

Nên kiểm thử hình ảnh do LINE lưu trữ, hình ảnh bên ngoài, video hoặc âm thanh đang chuẩn bị, nội dung không khả dụng và thao tác thu hồi khi đang tải. Đây là đề xuất kiểm thử, không phải kết quả đã thực hiện. Với luồng tiếp nhận chuẩn hóa, bắt đầu từ tài liệu message.received.

Nguồn chính thức được kiểm tra ngày 2026-11-17:

UnifyPort API

Biến tích hợp nhắn tin thành một pipeline sản phẩm ổn định.

Bắt đầu bằng cách gửi qua một API, rồi đưa mọi tin nhắn inbound trở lại hệ thống kinh doanh bằng sự kiện chuẩn.