LINGLI / 開發者文件
使用伺服器端金鑰存取伶俐數據 API
在伺服器端儲存伶俐 API 金鑰，以 X-API-Key 請求標頭呼叫對應 API，瞭解上線前的金鑰檢查與洩漏處理原則。
伶俐數據 · 更新於 2026年10月9日
伶俐公開串接範例使用 X-API-Key 請求標頭。你須在使用者中心建立自己的金鑰，並於伺服器端發起對應 API 請求。
金鑰的儲存位置
將金鑰放在伺服器端環境變數，或適合部署方式的憑證管理系統中。應用程式啟動時讀取設定，再透過請求標頭傳遞。前端頁面僅與自己的後端互動，不將真實金鑰傳送至瀏覽器。
本專案公開範例使用 LINGLI_API_KEY 作為環境變數名稱。這是應用程式設定名稱，API 驗證仍使用 X-API-Key 請求標頭。
上線前檢查
- 檢查程式碼儲存庫與建置產物，確認沒有真實金鑰。
- 檢查日誌、錯誤訊息、監控與截圖，避免輸出完整請求標頭。
- 核對實際請求網域與 API 路徑，不要依目前網頁網域組合 API 位址。
- 確認只有需要執行呼叫的服務能讀取憑證。
具體金鑰狀態、可用權限與 API 要求，以使用者中心及對應文件為準。
發現洩漏後的處理
停止傳播含金鑰的檔案或日誌，並透過使用者中心可用的管理功能處理原憑證。檢查可能受影響的呼叫紀錄、更新伺服器端設定，再驗證新設定。
在公開儲存庫刪除一行金鑰，不會自動消除歷史洩漏風險。若不確定應採取的管理操作，請先聯絡服務方確認處理方式。
控制台與伺服器端呼叫
控制台登入用於帳戶與 API 管理。伺服器端呼叫使用自行設定的 API 金鑰。串接程式應遵循 API 文件，不複製瀏覽器登入工作階段作為公開 API 驗證方案。