# API 存取狀態 帳戶 API 金鑰控制、正式合作夥伴整合與 Aiviance 內部路由之間的目前邊界。 Aiviance 目前沒有發布通用的公開 API 參考。本頁面記錄這一邊界,避免把產品內部路由誤認為受支援的外部契約。 ## API 金鑰是受控憑證 在相應能力已啟用時,登入後的產品可以為帳戶簽發、列出和撤銷 API 金鑰。金鑰內容只在簽發時顯示;儲存的金鑰經過雜湊處理,歸屬於明確的擁有者,並留下稽核記錄。不活躍滿 90 天的金鑰會被自動撤銷。 持有 API 金鑰並不代表所有 Aiviance 路由都成為公開介面。金鑰只能用於 Aiviance 已明確向該帳戶或合作夥伴提供文件的介面。 ## 內部路由不是 API 參考 Aiviance Web、行動端、顧問端與運作服務使用的 `/api/v1` 路由是應用配接器。除非某條路由出現在已批准的開發者契約中,否則其路徑、請求內容和回應結構都可能隨產品變化。 請勿透過發現或複製瀏覽器請求來建置整合。內部排程工作路由、回呼、webhook 和管理路由同樣不屬於通用公開介面。 ## 正式公開契約必須包含什麼 受支援的外部 API 會說明基礎 URL、驗證、權限範圍、實體所有權規則、版本、速率限制、錯誤格式、冪等要求和棄用政策。如果某個介面沒有提供這些資訊,應將其視為不可供外部使用。 如需申請受支援的整合,請向 Aiviance 提供使用情境、資料範圍、預計流量和安全模型。另請閱讀[開發者平台邊界](/docs/developers/platform-boundary)與[整合生命週期](/docs/developers/integrations)。