列出 API 版本

API 版本 2026-10-affable-towhee

get https://api.getlingara.com/v1/versions

按建立次序列出每個 API 版本，連同佢嘅 state、建立時間，同埋停用之後嘅終止日期。current 係最新嘅支援或者 LTS 版本，development 係仲喺度發展緊嘅版本；喺有呢種版本之前，兩個都係 null。唔使權杖。回應可以快取一個鐘。

權限範圍 唔需要驗證身份

參數

Lingara-Versionheaderstring選填: 回應呢個請求所用嘅 API 版本。冇呢個嘅話，存取權杖會用佢嘅用戶端綁定嘅版本，冇權杖嘅請求會用而家嘅版本。仲喺開發中嘅版本，只可以喺度指明先用到。唔認得嘅版本會回 400，代碼係 api_version_unknown。GET /v1/versions 會列出所有版本。

回應

200 所有 API 版本

currentstring | null必填

developmentstring | null必填

versionsarray of VersionSummary必填

idstring必填
stateVersionState必填
ltsboolean必填
minted_atstring必填
sunset_atstring | null必填

錯誤

410application/json: 回應呢個請求所用嘅 API 版本已經停用。請喺 Lingara-Version 傳一個有支援嘅版本，或者將用戶端綁去另一個版本。
4XXapplication/json: 請求被拒絕。code 講出原因，error 用文字解釋。
503application/json · text/plain: 服務暫時用唔到；請等 Retry-After 入面嘅秒數之後再試。維護期間，回應內容係純文字，而唔係錯誤封包。
5XXapplication/json: 請求被拒絕。code 講出原因，error 用文字解釋。

codestring必填: 請求被拒絕嘅原因，係一個穩定嘅代碼，可以用嚟做分支處理：例如 insufficient_scope（403）、rate_limited（429），對按用量收費嘅用戶端仲有 spend_cap_reached（402）同 metered_billing_inactive（402）。
errorstring必填

例子

curlTypeScriptRustGoJavaKotlinRubyPHP

curl

curl "https://api.getlingara.com/v1/versions"

TypeScript

const list = await client.listApiVersions();
console.log("current:", list.current);
for (const v of list.versions) console.log(v.id, v.state);

Rust

let list = client.list_api_versions().await?;
println!("current: {}", list.current.as_deref().unwrap_or("(none)"));
for version in &list.versions {
    println!("{} {:?}", version.id, version.state);
}

versions, err := client.ListAPIVersions(ctx)
if err != nil {
	return err
}
for _, v := range versions.Value.Versions {
	fmt.Println(v.ID, v.State, v.Lts)
}

Java

import com.getlingara.client.model.VersionSummary;

for (VersionSummary version : client.listApiVersions().body().getVersions()) {
  System.out.println(version.getId() + " " + version.getState() + " " + version.getLts());
}

Kotlin

for (version in client.listApiVersions().body.versions) {
    println("${version.id} ${version.state} ${version.lts}")
}

Ruby

list = client.list_api_versions.value
puts "current: #{list.current}"
list.versions.each { |version| puts "#{version.id} #{version.state}" }

PHP

// Needs no token: a client built without credentials can call it.
$versions = $client->listApiVersions()->value;
echo 'current: ', $versions->getCurrent(), "\n";
foreach ($versions->getVersions() as $version) {
    echo $version->getId(), ' ', $version->getState()->value, "\n";
}

想用程式庫？睇吓程式庫部分。

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