← 所有文章
指南

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 驗證。它不會傳送客戶訊息,因此適合作為第一項檢查。

執行前先做好準備:

  1. 選定測試 channel,記錄它對應的 LINE 官方帳號。
  2. 透過受保護的本機環境,將 token 載入 LINE_CHANNEL_ACCESS_TOKEN。這是範例環境變數名稱,不是 LINE API 欄位。
  3. 使用可信任的終端機並關閉命令追蹤。不要將真實 token 貼進共用文件、截圖或錄影。
  4. 若不確定該用哪個憑證,先閱讀 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。

UnifyPort API

讓訊息接入變成一條穩定的產品管線。

先用統一 API 跑通傳送,再用標準事件把所有入站訊息接回業務系統。