列出 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";
}

更喜欢用库？请参阅“库”部分。

如译文与英文参考文档不一致，以英文参考文档为准。