ดาวน์โหลดสื่อ LINE ไม่ได้: แยกสถานะ 202 และไฟล์จากภายนอก
การรับ webhook สื่อจาก LINE ไม่ได้หมายความว่าได้รับไฟล์แล้ว สำหรับรูปภาพ วิดีโอ และเสียง ให้ตรวจ message.contentProvider.type ก่อน: ค่า line ใช้ Get content ของ LINE ส่วน external ใช้ URL ของเนื้อหาต้นฉบับที่มากับเหตุการณ์ สถานะ 202 ระหว่างเตรียมวิดีโอหรือเสียงไม่ใช่การดาวน์โหลดสำเร็จ LINE ไม่รับประกันระยะเวลาเก็บเนื้อหาที่ผู้ใช้ส่ง จึงควรบันทึกเนื้อหาที่มีสิทธิ์ประมวลผลโดยเร็ว ไม่ใช่ถือว่ารหัสข้อความเป็นคลังถาวร
ประเด็นสำคัญ
- เลือกวิธีดาวน์โหลดตามแหล่งเนื้อหา ไม่ใช่ดูแค่ชนิดสื่อ
- 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 ด้วยรหัสข้อความ | เก็บข้อมูลประกอบของไฟล์ และอย่าคิดว่าทุกข้อความมี contentProvider |
| ข้อความตัวอักษร | บันทึกข้อความจาก webhook | ไม่มี API สำหรับดึงข้อความเดิมซ้ำในภายหลัง |
สองแถวสุดท้ายสำคัญต่อกล่องข้อความรวม อย่าปฏิเสธไฟล์เพียงเพราะไม่มี contentProvider ที่โค้ดสำหรับรูปภาพต้องการ และอย่าส่งรหัสข้อความตัวอักษรไปยังขั้นตอนดาวน์โหลดไบนารี
สำหรับสื่อที่ LINE จัดเก็บ คำขอคือ GET /v2/bot/message/{messageId}/content บน api-data.line.me โดยยืนยันตัวตนด้วย channel access token เก็บโทเคนไว้ที่ backend เท่านั้น ใช้รหัสข้อความจากเหตุการณ์ที่ตรวจลายเซ็นแล้วและตรงกับ channel นั้น ไม่ใช่รหัสผู้ใช้ reply token หรือรหัสเหตุการณ์
คู่มือรับข้อความ ยังอธิบายการดึงภาพตัวอย่างของรูปภาพและวิดีโอด้วย ภาพตัวอย่างช่วยแสดงหน้าจอระหว่างโหลดได้ แต่ไม่ใช่หลักฐานว่าไฟล์ต้นฉบับถูกดาวน์โหลดหรือบันทึกแล้ว
ตรวจผลลัพธ์ก่อนลองใหม่
ตาม ข้อกำหนด Get content สถานะ 200 ที่สำเร็จจะส่งเนื้อหาไบนารี โดยระบุรูปแบบใน header Content-Type วิดีโอหรือเสียงขนาดใหญ่อาจยังอยู่ระหว่างเตรียมและตอบกลับเป็น 202
| สิ่งที่พบ | การดำเนินการที่แนะนำ |
|---|---|
200 พร้อมเนื้อหาไบนารี | สตรีมไปยังพื้นที่จัดเก็บที่ควบคุม ตรวจเนื้อหา และบันทึกว่าสำเร็จเมื่อจัดเก็บเสร็จจริง |
202 ขณะดึงวิดีโอหรือเสียง | คงงานไว้ในสถานะรอ ตรวจความพร้อม แล้วจึงดาวน์โหลดภายหลัง |
404 หรือ 410 | ตรวจรหัสข้อความ channel แหล่งเนื้อหา และข้อผิดพลาด อย่าคิดว่าลองซ้ำไม่จำกัดแล้วจะกู้ไฟล์ได้ |
| URL ภายนอกใช้ไม่ได้ | ตรวจโฮสต์ภายนอกและความพร้อมของ URL; content API ของ LINE ไม่ใช่ทางสำรอง |
| มีภาพย่อแต่ไม่มีต้นฉบับ | ติดตามสองสถานะแยกกัน อย่าระบุว่าไฟล์แนบถูกบันทึกครบแล้ว |
endpoint สำหรับตรวจการเตรียมคือ GET /v2/bot/message/{messageId}/content/transcoding ตาม เอกสาร API ให้ใช้โดเมนและรูปแบบผลลัพธ์ของ endpoint นั้นเอง ไม่ใช่นำโดเมนดาวน์โหลดไบนารีไปใช้กับทุกคำขอ
กำหนดตาราง polling และจำนวนครั้งที่ลองใหม่อย่างมีขอบเขตตามความต้องการของแอป นี่เป็นคำแนะนำด้านปฏิบัติการ ไม่ใช่การรับประกันเวลาจาก LINE อย่าถือว่าทุก HTTP response ในกลุ่มสำเร็จเป็นไฟล์ และอย่าส่ง response ระหว่างเตรียมไปยังตัวถอดรหัสภาพหรือบริการถอดเสียง
บันทึกโดยเร็ว แต่ยังต้องรองรับการยกเลิกส่ง
LINE ระบุว่าเนื้อหาจะถูกลบอัตโนมัติหลังช่วงเวลาหนึ่ง และไม่รับประกันระยะเวลาเก็บ การมีรหัสข้อความจึงยืนยันเพียงว่าคุณบันทึกรหัสไว้ ไม่ใช่ว่าจะเข้าถึงไฟล์ได้ในอนาคต
ลำดับการทำงานที่แนะนำ:
- ตรวจแหล่งที่มาและบันทึกเหตุการณ์อย่างถาวร พร้อมบริบทของ channel และข้อความ
- สร้างงานดาวน์โหลดที่กลับมาทำต่อได้ควบคู่กับข้อมูลที่รับไว้ คู่มือรับ LINE webhook หลายเหตุการณ์ อธิบายว่าทำไมจึงไม่ควรตอบว่าสำเร็จเมื่อบันทึกได้เพียงบางเหตุการณ์
- ดึงต้นฉบับจากแหล่งที่ถูกต้อง ตรวจขนาด timeout และเนื้อหาก่อนส่งให้เจ้าหน้าที่หรือเครื่องมือ AI
- เก็บการอ้างอิงไปยังไฟล์ในระบบของคุณ และควบคุมสิทธิ์ตามบทสนทนา อย่าเชื่อถือชื่อไฟล์หรือชนิดสื่อที่แจ้งมาโดยอัตโนมัติ
- ถ้าดึงไฟล์ไม่ได้ ให้แสดงสถานะว่าไฟล์แนบไม่พร้อมใช้งาน และขอให้ส่งใหม่อย่างเหมาะสมภายใต้สิทธิ์ที่มี
สำหรับ URL ภายนอก ให้ตรวจปลายทางและ redirect ป้องกันการเข้าถึงเครือข่ายส่วนตัว และห้ามส่ง LINE channel token ต่อไปยังโฮสต์ภายนอก หลีกเลี่ยงการบันทึกโทเคนและ query string ของ URL ที่ลงลายเซ็นลง log มาตรการเหล่านี้เป็นคำแนะนำสำหรับ worker ไม่ใช่สิ่งที่ LINE รับรองว่าทำให้แล้ว
การเก็บไฟล์สร้างหน้าที่ในการลบสำเนาด้วย ใช้ ขั้นตอนจัดการ LINE unsend และตรวจสถานะการลบอีกครั้งก่อนเผยแพร่ผลดาวน์โหลด งานที่เสร็จหลังยกเลิกส่งต้องไม่ทำให้ไฟล์แนบกลับมาปรากฏในกล่องข้อความ
แยกข้อกำหนดไฟล์แนบของ UnifyPort
อินเทอร์เฟซที่ไม่เป็นทางการของ UnifyPort ส่งเหตุการณ์มาตรฐาน message.received ไม่ใช่ออบเจ็กต์ข้อความ LINE ดั้งเดิม สื่ออยู่ใน data.message.attachments[] และ เอกสารเหตุการณ์มาตรฐาน ระบุ URL ของ OSS ที่ลงลายเซ็นและใช้ชั่วคราว ชนิดไฟล์แนบ และข้อมูลประกอบสื่อ
อย่าส่งรหัสข้อความมาตรฐานไปยัง LINE Get content หรือคาดว่าจะมี contentProvider ประมวลผล URL ที่ได้รับตามนโยบายการเก็บข้อมูล หากไม่มี URL ให้บันทึกข้อจำกัดแทนการสร้าง URL เอง เอกสารสาธารณะไม่ได้ระบุ endpoint สำหรับต่ออายุ URL ไฟล์แนบ และไม่รับประกันการส่งข้อความที่พลาดไปซ้ำ
สำหรับตัวรับแยกนี้ ให้ตั้ง signing_secret และทำตาม ข้อกำหนดการส่ง webhook เพื่อตรวจ HMAC-SHA256 จาก request body ดิบและบันทึกเหตุการณ์อย่างถาวร ลายเซ็นถูกต้องยืนยันการส่งเท่านั้น ไม่ได้ยืนยันว่าไฟล์ยังดาวน์โหลดได้หรือปลอดภัยต่อการประมวลผล
หากต้องใช้ตัวตน LINE Official Account และข้อกำหนดเนื้อหาดั้งเดิม ให้ใช้ Messaging API ทางการต่อไป UnifyPort ไม่ใช่บริการกู้ไฟล์แนบที่หายไปจาก Official Account
คำถามที่พบบ่อย
202 หมายความว่าดาวน์โหลดไฟล์สำเร็จหรือไม่?
ไม่ใช่ วิดีโอหรือเสียงที่ยังเตรียมไม่เสร็จอาจตอบ 202 โดยไม่มีไบนารี ให้ตรวจความพร้อมแล้วดาวน์โหลดภายหลังตามนโยบายการลองใหม่
Get content ดาวน์โหลดรูปภาพ external ได้ไหม?
ไม่ได้ เมื่อ contentProvider.type: external ให้ใช้ contentProvider.originalContentUrl พร้อมมาตรการดาวน์โหลดอย่างปลอดภัยของคุณเอง
LINE เก็บเนื้อหาไว้กี่วัน?
LINE ไม่รับประกันระยะเวลา อย่าสัญญาในหน้าจอฝ่ายบริการว่าจะกู้ไฟล์ได้แน่นอนภายในจำนวนวันที่กำหนด
ขั้นตอนถัดไปและแหล่งข้อมูล
ควรทดสอบรูปภาพที่ LINE จัดเก็บ รูปภาพภายนอก วิดีโอหรือเสียงระหว่างเตรียม เนื้อหาที่ดึงไม่ได้ และการยกเลิกส่งระหว่างดาวน์โหลด นี่เป็นรายการทดสอบที่แนะนำ ไม่ใช่ผลการทดสอบที่ดำเนินการแล้ว สำหรับการรับเหตุการณ์มาตรฐาน เริ่มที่ เอกสาร message.received
ตรวจสอบแหล่งข้อมูลทางการวันที่ 2026-11-17:
เปลี่ยนการเชื่อมต่อข้อความให้เป็น pipeline ผลิตภัณฑ์ที่เสถียร
เริ่มจากการส่งผ่าน API เดียว แล้วส่งข้อความขาเข้าทั้งหมดกลับสู่ระบบธุรกิจของคุณด้วย event มาตรฐาน