版本

API 版本 2026-10-affable-towhee

Lingara API 以名稱區分版本，格式為 yyyy-mm-adjective-noun。每個路徑中的 /v1 永遠不變：一次呼叫接受什麼、傳回什麼，由版本決定。

用戶端的版本

用戶端會固定在建立時的目前版本上，使用其任一存取權杖且未帶版本標頭的呼叫，都會以該版本回應。用戶端的擁有者可以在整合頁面（網址為 app.getlingara.com/admin）將它重新固定到另一個受支援的版本；它的存取權杖從下一次換取起使用新版本。

單次呼叫的版本

在呼叫中傳送 Lingara-Version: <id>，即可以該版本取代固定的版本；回應會註明所用的版本。開發版本只能透過這種方式存取，且可能隨時變更，恕不另行通知。

版本的生命週期

可以固定的版本為 supported，維護時間更長的版本為 lts。deprecated 版本仍會回應，每個回應都帶有 Deprecation 和 Sunset 標頭，且在被棄用後至少 90 天才會結束。discontinued 版本會以 410 和代碼 api_version_discontinued 拒絕。

已發布的版本

如譯文與英文參考文件有出入，以英文參考文件為準。