版本

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

已發佈嘅版本

如果譯本同英文參考文件有出入，以英文參考文件為準。