Lỗi endpoint LINE Messaging API: kiểm tra dấu gạch chéo cuối đường dẫn
Khi gọi LINE Messaging API, hãy dùng đúng endpoint trong tài liệu. Đừng thêm dấu gạch chéo ở cuối hoặc mặc định rằng đường dẫn đã sửa vẫn tương đương. LINE nêu rõ rằng hành vi của endpoint không chính xác, bao gồm dấu / thừa ở cuối, không được bảo đảm. Trước khi đổi thông tin xác thực, nội dung tin nhắn hay cấu hình webhook, hãy kiểm tra URL mà HTTP client thực sự gửi đi.
Điểm chính
- Kiểm tra method, host và path cuối cùng, không chỉ địa chỉ trong màn hình cấu hình.
- Cảnh báo của LINE không bảo đảm một mã lỗi hay chuyển hướng cụ thể cho đường dẫn sai.
- Địa chỉ API và URL nhận webhook của bạn là hai ranh giới tích hợp khác nhau.
- Sửa URL không chứng minh lần gửi bị timeout trước đó chưa thành công.
LINE nói gì về dấu gạch chéo cuối đường dẫn?
Trong thông báo ngày 17 tháng 8 năm 2026, LINE yêu cầu dùng endpoint chính xác được liệt kê trong Messaging API reference. Dấu gạch chéo thừa ở cuối được nhắc đến trực tiếp. Đây là giải thích về hợp đồng API, không phải thông báo về một sự cố cụ thể hay cam kết mọi đường dẫn sai đều trả về 404.
Messaging API reference hiện hành liệt kê các đường dẫn sau:
| Thao tác | Method và đường dẫn theo tài liệu | Không thêm |
|---|---|---|
| Gửi tin nhắn trả lời | POST /v2/bot/message/reply | / ở cuối |
| Gửi tin nhắn push | POST /v2/bot/message/push | / ở cuối |
| Đọc hạn mức tin nhắn | GET /v2/bot/message/quota | / ở cuối |
Đây là ví dụ cú pháp đường dẫn, không phải các thao tác có thể thay thế cho nhau. Vẫn phải tuân thủ yêu cầu xác thực và body của từng thao tác. Đừng chuyển reply thành push chỉ vì yêu cầu ban đầu thất bại.
LINE cũng khuyến nghị dùng SDK chính thức để tạo URL endpoint chính xác. Tuy nhiên, nếu có lớp truyền tải tùy chỉnh, proxy hoặc hàm bọc của ứng dụng, vẫn cần kiểm tra yêu cầu đầu ra của những lớp này.
Kiểm tra yêu cầu thực sự được gửi đi
Quy trình dưới đây là đề xuất chẩn đoán, không phải danh sách nguyên nhân sự cố LINE đã được xác nhận.
- Xác định thao tác bị lỗi. Phân biệt ứng dụng gọi LINE với việc nhận webhook từ LINE. Ghi lại method và đích đến theo tài liệu của thao tác đó.
- Kiểm tra cách ghép URL. Xem cấu hình URL gốc, nối đường dẫn, HTTP node trong công cụ no-code và các hàm dùng chung tự thêm dấu gạch chéo. So sánh giá trị đã ghép với reference từng ký tự.
- Kiểm tra thành phần gửi cuối cùng. Nếu proxy đầu ra hoặc middleware có thể viết lại đường dẫn, so sánh đích đến của nó với giá trị do ứng dụng tạo. Cấu hình đúng không có nghĩa lớp phía sau không sửa đổi.
- Lưu bằng chứng đã loại bỏ dữ liệu nhạy cảm. Giữ method, host, path, thời điểm quan sát, HTTP status và phản hồi lỗi đã làm sạch. Không ghi header xác thực, access token, reply token hoặc nội dung tin nhắn khách hàng.
- Chỉ sửa sai lệch đã xác nhận. Đừng đồng thời đổi khóa, người nhận và URL webhook. Nếu thử lại thành công, bạn sẽ không biết thay đổi nào giải quyết vấn đề.
Đừng tạo quy tắc toàn cục “xóa mọi dấu gạch chéo”. Giữ nguyên dấu phân cách của host và cấu trúc đường dẫn trong tài liệu; sửa cách tạo URL của thao tác cụ thể.
Chọn bước tiếp theo theo triệu chứng còn lại
| Quan sát | Hướng kiểm tra tiếp theo |
|---|---|
| Đường dẫn cuối cùng khác reference | Sửa bộ tạo yêu cầu và kiểm tra đầu ra cục bộ |
| Method và path đúng nhưng yêu cầu bị từ chối | Kiểm tra phản hồi thực tế, thông tin xác thực và body của thao tác |
| Verify trong LINE Developers Console thất bại | Kiểm tra URL nhận và handler của bạn, không phải endpoint push |
| Gửi tin nhắn bị timeout | Lưu trạng thái chưa rõ kết quả trước khi cân nhắc gửi lại |
Nếu handler từ chối payload kiểm tra rỗng, xem hướng dẫn LINE Webhook Verify và events rỗng. Vấn đề đó nằm ở yêu cầu đi vào máy chủ của bạn, không phải dấu gạch chéo thêm vào đích API của LINE.
Với thao tác gửi có hỗ trợ retry key bị timeout, dùng riêng quy trình retry key của LINE. Tài liệu retry của LINE yêu cầu có key từ yêu cầu đầu tiên trên các phương thức được hỗ trợ. Sửa đường dẫn không thể bảo vệ ngược lại lần thử trước đó không có key. Đừng gửi lại tin nhắn thật chỉ để thử định dạng URL.
Tách riêng đích đến của UnifyPort
Giao diện không chính thức của UnifyPort sử dụng API riêng cho tài khoản nhắn tin đã kết nối. Tài liệu gửi văn bản quy định POST /v1/messages với account_id, to và message, xác thực bằng X-Api-Key. Đây không phải endpoint của LINE Messaging API dù nhà cung cấp được kết nối là LINE.
Có thể áp dụng nguyên tắc kiểm tra đúng đích theo tài liệu cho cả hai tích hợp, nhưng không được chuyển đường dẫn, thông tin xác thực hay bảo đảm retry của LINE sang UnifyPort. Nếu bên gửi phải là LINE Official Account, hãy dùng Messaging API chính thức. Đổi sang tích hợp khác không giải đáp được yêu cầu chính thức trước đó đã được chấp nhận hay chưa.
Kiểm tra hồi quy và câu hỏi thường gặp
Thêm dấu gạch chéo có luôn gây lỗi 404 không?
Cảnh báo của LINE không đưa ra bảo đảm đó. Hãy kiểm tra phản hồi thực tế và dùng endpoint trong tài liệu.
Có cần xóa dấu gạch chéo cuối URL webhook của mình không?
Không thể quyết định chỉ dựa vào thông báo này. URL nhận phải khớp với định tuyến máy chủ của bạn. Cảnh báo nói về yêu cầu đến Messaging API, không phải quy tắc chung cho mọi URL website hay webhook.
Nên kiểm tra gì trước khi phát hành bản sửa?
Trước tiên, xác nhận method và URL cuối cùng của từng thao tác bị ảnh hưởng mà không gửi tin nhắn thật. Kiểm tra cấu hình URL gốc có và không có dấu gạch chéo cuối, hàm bọc HTTP dùng chung và cấu hình proxy production. Nếu cần xác nhận đầu cuối, dùng tài khoản do bạn kiểm soát cùng thao tác thử nghiệm đã chọn rõ ràng. Đây là các kiểm tra được đề xuất, không phải kết quả đã thực hiện.
Bước tiếp theo và nguồn
So sánh một yêu cầu đầu ra bị lỗi với LINE Messaging API reference. Với tích hợp UnifyPort riêng biệt, dùng hợp đồng gửi văn bản.
Nguồn chính thức được kiểm tra ngày 2026-11-03:
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.