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

LINE API Playground sắp ngừng hoạt động: chuyển kiểm thử sang curl

LINE dự kiến ngừng API Playground trong tài liệu tham chiếu Messaging API vào ngày 30/11/2026. Messaging API không bị ngừng hoạt động. LINE khuyến nghị dùng công cụ như curl để gửi yêu cầu theo ví dụ của từng endpoint. Hãy thay hướng dẫn kiểm thử trên trình duyệt, không phải hệ thống tích hợp đang chạy; bắt đầu bằng yêu cầu chỉ đọc rồi kiểm thử gửi tin riêng.

Điểm chính

  • Thay đổi này loại bỏ công cụ kiểm thử trên trình duyệt, không loại bỏ Messaging API.
  • Lưu mẫu yêu cầu riêng với channel access token thật.
  • Đọc thông tin bot thành công không chứng minh tin nhắn đã tới người nhận hay Webhook nhận được sự kiện.
  • Đổi công cụ kiểm thử không bắt buộc đổi danh tính người gửi hoặc chuyển sang UnifyPort.

LINE sẽ ngừng phần nào?

Thông báo ngày 13/11 trong trang tin năm 2026 của LINE mô tả API Playground là tính năng trong tài liệu tham chiếu, cho phép gửi yêu cầu tới một số endpoint và xem phản hồi ngay trên trình duyệt. LINE cho biết quyết định dựa trên việc xem xét mức sử dụng và yêu cầu bảo mật để tiếp tục vận hành, đồng thời khẳng định Messaging API không bị ảnh hưởng.

Tại thời điểm kiểm tra bài viết ngày 19/11, đây vẫn là lịch ngừng hoạt động dự kiến, không phải sự cố đã xảy ra. Thông báo chỉ nói về công cụ cụ thể này; không nên suy rộng sang mọi công cụ phát triển của LINE.

Rà soát tài liệu hướng dẫn tích hợp, quy trình xử lý lỗi và ảnh chụp có bước “nhấn Try”. Thay bằng mẫu yêu cầu đã được kiểm tra, nguồn lấy thông tin xác thực và cách đọc phản hồi. Chỉ vì nút này sắp biến mất không có nghĩa phải viết lại ứng dụng đang dùng.

Thay kiểm thử đầu tiên bằng yêu cầu chỉ đọc

Tài liệu tham chiếu Messaging API có GET /v2/bot/info để lấy thông tin cơ bản của LINE Official Account, xác thực bằng channel access token. Đây là phép kiểm tra đầu tiên phù hợp vì không gửi tin cho khách hàng.

Trước khi chạy:

  1. Chọn channel thử nghiệm và ghi rõ LINE Official Account tương ứng.
  2. Nạp token vào LINE_CHANNEL_ACCESS_TOKEN qua môi trường cục bộ được bảo vệ. Đây là tên biến minh họa, không phải trường của LINE API.
  3. Dùng terminal đáng tin cậy và tắt chế độ truy vết lệnh. Không dán token thật vào tài liệu chia sẻ, ảnh chụp hoặc bản ghi màn hình.
  4. Nếu chưa rõ thông tin xác thực cần dùng, xem hướng dẫn tìm channel access token. Đừng cấp lại thông tin xác thực đang hoạt động chỉ để đổi công cụ kiểm thử.

Yêu cầu shell dưới đây chỉ để minh họa, chưa được chạy khi viết bài:

printf 'Authorization: Bearer %s\n' "$LINE_CHANNEL_ACCESS_TOKEN" |
  curl --silent --show-error --include \
    --header @- \
    'https://api.line.me/v2/bot/info'

Header xác thực được truyền qua đầu vào chuẩn thay vì ghi token thật trực tiếp trong nội dung lệnh. Cách này không thay thế một giải pháp quản lý bí mật đầy đủ: môi trường và terminal vẫn cần được bảo vệ. Không bật truy vết chi tiết hay tải lên dữ liệu chẩn đoán chưa che thông tin nhạy cảm.

Kiểm tra HTTP status và nội dung phản hồi, sau đó so sánh thông tin tài khoản trả về với người gửi dự kiến. Yêu cầu thành công nhưng trả về tài khoản khác vẫn là kiểm tra cấu hình không đạt. Nếu chưa có HTTP response thì kết quả API chưa được xác định; cần phân biệt với một lỗi API đã được trả về rõ ràng.

Nếu yêu cầu khác tài liệu, dùng checklist URL endpoint của LINE để đối chiếu method, host và path thực tế. Đừng thay thông tin xác thực và nội dung yêu cầu cùng lúc.

Tách ba loại kết quả kiểm thử

Kiểm thửCó thể xác nhậnKhông xác nhận
Đọc thông tin botYêu cầu này đã xác thực và trả về danh tính tài khoảnTin tới khách hàng hoặc Webhook hoạt động
Chủ động gửi cho người thử nghiệm đã đồng ýKết quả quan sát được của lần gửi đóMọi người nhận khác đều nhận được
Nhận tin mới qua WebhookĐường nhận của sự kiện cụ thể đóMọi thao tác gửi đều hoạt động

Nếu cần kiểm thử gửi, chủ động chọn phương thức và người nhận theo tài liệu chính thức. Không dùng một yêu cầu production đã lưu làm phép thử kết nối. Lần kiểm tra thủ công đầu tiên không nên kèm tự động gửi lại: phản hồi bị mất có thể để lại kết quả chưa rõ. Với thiết kế thử lại cho các phương thức được hỗ trợ, xem riêng hướng dẫn LINE retry key.

Trong quy trình mới, nên lưu loại thao tác, nhãn channel thử nghiệm, thời điểm quan sát, HTTP status và bản tóm tắt phản hồi đã loại bỏ dữ liệu nhạy cảm. Không đưa access token hay nội dung tin của khách vào bằng chứng chia sẻ. Đây là các mục ghi nhận nội bộ được đề xuất, không phải trường phản hồi mới của LINE.

Vai trò và giới hạn của UnifyPort

UnifyPort là giao diện không chính thức riêng biệt, không phải nơi lưu trữ thay thế cho LINE API Playground. Tài liệu gửi tin văn bản quy định POST /v1/messages, xác thực bằng X-Api-Key và các trường account_id, to, message. Không thể dán trực tiếp LINE channel access token cùng yêu cầu Messaging API vào hợp đồng này.

Nếu đang dùng UnifyPort, hãy duy trì hướng dẫn kiểm thử riêng cho API và sự kiện đầu vào của dịch vụ. Nếu cần danh tính gửi của LINE Official Account và tính năng chính thức, tiếp tục dùng Messaging API. Việc gỡ giao diện kiểm thử không phải lý do để chuyển tài khoản nhắn tin hay thay Webhook production.

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

LINE Messaging API có đóng vào ngày 30/11 không?

Không. Thông báo lên lịch ngừng API Playground và nói rõ Messaging API không bị ảnh hưởng.

Có cần token mới cho curl không?

Chỉ đổi HTTP client không tạo ra yêu cầu xoay vòng token. Dùng token còn hiệu lực của channel mong muốn và bảo vệ nó riêng với mẫu yêu cầu đã lưu.

Lấy thông tin bot thành công có chứng minh bot nhận được tin không?

Không. Cần kiểm thử Webhook đầu vào riêng. Thông tin tài khoản cũng không phải bằng chứng khách hàng đã nhận tin gửi đi.

Bước tiếp theo và nguồn tham khảo

Thay một bước “nhấn Try” trong tài liệu nội bộ bằng phép kiểm tra chỉ đọc từ tài liệu Messaging API chính thức, rồi bổ sung kiểm thử gửi và nhận riêng.

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

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.