API 金鑰與呼叫安全

準備 API Key

從控制台頭像選單進入 Settings，再開啟個人中心的 API Key。每個帳號僅一個有效金鑰；重新產生立即使舊金鑰失效，完整值只顯示一次。每次帶 X-API-Key，POST 加 Content-Type: application/json。不需網頁 JWT、Cookie、Device-ID、hash 或 platform；Bearer Token 無法替代。

API Key 安全管理

只在伺服器環境變數或金鑰系統保存，勿放入前端、公開倉庫或客戶端。勿寫入 URL、本文、日誌或工單；範例使用 API_KEY。洩漏請立即輪換或停用並更新所有呼叫端，舊金鑰輪換後失效。

錯誤處理與重試

400 修正參數，401/403 查金鑰及帳號，409 排除衝突，429 退避。查詢可在額度內重試。寫入無公開冪等鍵；逾時或 500 後先核實是否受理再重試。應用不存在、版本不符或提交失敗也可能為 500 / PUBLIC_API_INTERNAL_ERROR，不能視為未執行證據。

接入驗證與支援

提供 request_id、路徑、HTTP 狀態、reason、時間及遮蔽參數，勿提供金鑰。先用唯讀清單驗證，再於已授權測試裝置執行寫入，核對結果後擴大批次。

相關文件

• 公共 API 使用指南
• 問題排查與客服資訊