LINE API Playground 即將停用:改用 curl 測試
LINE 計劃於 2026 年 11 月 30 日停用 Messaging API reference 內的 API Playground,並非停止提供 Messaging API。官方建議改用 curl 等工具,按各端點文件的範例發出請求。要更新的是瀏覽器測試流程,而不是正常運作的 API 整合;先做唯讀查詢,再獨立測試訊息發送。
重點
- 停用的是瀏覽器測試功能,不是 Messaging API。
- 請求範本與真正的 channel access token 應分開儲存。
- 成功讀取機械人資訊,不代表訊息已送達或 Webhook 接收正常。
- 更換測試工具,不要求更換發送身份或遷移至 UnifyPort。
LINE 實際停用甚麼
LINE 2026 年新聞中的 11 月 13 日公告指出,API Playground 是 API reference 的功能,可在瀏覽器向部分端點發出請求及查看回應。LINE 表示,決定考慮了使用情況與持續營運的安全要求,並明確說明 Messaging API 本身不受影響。
截至本文 11 月 19 日核實時,這仍是計劃中的停用,不是已發生的服務中斷。公告只針對這項參考文件工具,不應延伸解讀為所有 LINE 開發工具都會停用。
檢查團隊的接入文件、疑難排解步驟及截圖,找出「按 Try」的指示。以經審核的請求範例、憑證來源和回應判讀方法取代。僅因該按鈕將被移除,毋須重寫現有應用程式。
先以唯讀查詢取代首次測試
Messaging API reference列出 GET /v2/bot/info,用來取得 LINE 官方帳戶的基本資訊,並要求 channel access token 認證。這項操作不會向客戶發送訊息,適合作為第一項檢查。
執行前:
- 選定測試 channel,記錄對應的 LINE 官方帳戶。
- 透過受保護的本機環境,將 token 載入
LINE_CHANNEL_ACCESS_TOKEN。這是示例環境變數名稱,不是 LINE API 欄位。 - 使用可信的終端機並關閉命令追蹤。不要把真實 token 貼到共享文件、截圖或錄影中。
- 若不確定應用哪項憑證,先查看 channel access token 位置指南。不要只為更換測試工具而重新簽發仍在使用的憑證。
以下 shell 請求僅作示例,本文沒有執行:
printf 'Authorization: Bearer %s\n' "$LINE_CHANNEL_ACCESS_TOKEN" |
curl --silent --show-error --include \
--header @- \
'https://api.line.me/v2/bot/info'
此處經標準輸入提供認證標頭,而非將 token 直接寫進命令文字。這不等於完整的密鑰管理方案:環境變數及終端機仍須保護。不要開啟詳細追蹤,亦不要上載未遮蔽敏感資料的診斷紀錄。
檢查 HTTP 狀態和回應內容,再核對返回的帳戶資訊是否符合預期發送方。請求成功但返回另一個帳戶,仍代表設定檢查不合格。未收到 HTTP 回應,則 API 結果尚未確定;這與收到明確 API 錯誤不同。
若請求與文件不符,按照 LINE 端點 URL 檢查清單核對最終 method、host 及 path,不要同時修改憑證與請求內容。
分開記錄三種測試結果
| 測試 | 可以確認甚麼 | 不能確認甚麼 |
|---|---|---|
| 讀取機械人資訊 | 該次請求通過認證並返回帳戶身份 | 客戶訊息送達或 Webhook 正常 |
| 向同意參與的測試者發送 | 該次發送操作的實際觀察結果 | 所有其他收件人都能收到 |
| 經 Webhook 接收新訊息 | 該事件的接收路徑 | 所有發送操作正常 |
如要測試發送,按官方文件明確選擇方法及測試收件人。不要將儲存的正式環境請求用作連線測試。首次手動檢查先不要加入自動重試;回應遺失可能留下不確定結果。有關支援重試鍵的發送設計,請另看 LINE retry key 指南。
新版操作手冊建議保留操作類型、測試 channel 標籤、觀察時間、HTTP 狀態,以及已遮蔽敏感資料的回應摘要。共享證據不應包含 access token 或客戶訊息內容。這些是建議的本地紀錄,並非 LINE 新增的回應欄位。
UnifyPort 的角色與界線
UnifyPort 提供獨立的非官方介面,不是 LINE API Playground 的替代網站。文字訊息發送文件定義 POST /v1/messages,採用 X-Api-Key 認證,請求欄位包括 account_id、to 和 message。不能把 LINE channel access token 及原生 Messaging API 請求直接套用。
已使用 UnifyPort 的團隊,應為其 API 與接收事件另設測試說明。如果需要 LINE 官方帳戶的發送身份及官方功能,繼續使用 Messaging API 即可。測試介面被移除,不是遷移訊息帳戶或變更正式環境 Webhook 的理由。
常見問題
LINE Messaging API 會於 11 月 30 日關閉嗎?
不會。公告計劃移除的是 API Playground,並明確說明 Messaging API 本身不受影響。
改用 curl 需要新 token 嗎?
僅更換 HTTP 用戶端,不代表需要輪換 token。使用目標 channel 的有效 token,並與儲存的請求範本分開保護。
成功取得機械人資訊,能證明它可以接收訊息嗎?
不能。Webhook 接收需要獨立測試;帳戶資訊查詢亦不是客戶已收到訊息的證據。
下一步與資料來源
先將一處內部「按 Try」的說明,改為官方 Messaging API reference的唯讀檢查,再分別補上發送及接收測試。
官方資料核實日期:2026-11-19。
令訊息接入變成一條穩定嘅產品管線。
先用統一嘅 API 跑通發送,再用標準事件將所有入站訊息接返去業務系統。