版本

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 拒絕。

已經發佈的版本

若是翻譯佮英文參考文件無仝，就以英文參考文件為準。