攞一個 API 版本

API 版本 2026-10-affable-towhee

get https://api.getlingara.com/v1/versions/{id}

傳返一個 API 版本，連同佢完整嘅 history、summary（英文）同 spec。spec.url 嘅文件，要用 Lingara-Version 標頭設做佢嘅 id 嚟請求，先至係呢個版本嘅文件。spec.sha256 係佢凍結文件嘅雜湊值，版本仲發展緊嘅時候係 null。唔識嘅 id 會回應 404。唔使權杖。回應可以快取一個鐘。

權限範圍 唔需要驗證身份

參數

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

回應

200 API 版本

idstring必填

stateVersionState必填

ltsboolean必填

minted_atstring必填

sunset_atstring | null必填

summarystring | null必填

historyarray of VersionHistoryEntry必填

stateVersionState必填
atstring必填

specVersionSpec必填

urlstring必填
sha256string | null必填

asyncapiVersionSpec必填

urlstring必填
sha256string | 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/$ID"

TypeScript

const version = await client.getApiVersion({ id: "2026-09-knowing-tenpounder" });
console.log(version.id, version.state, version.summary);

Rust

let version = client.get_api_version("2026-09-knowing-tenpounder").await?;
println!("{} {:?} {}", version.id, version.state, version.summary.as_deref().unwrap_or(""));

version, err := client.GetAPIVersion(ctx, "2026-09-knowing-tenpounder")
if err != nil {
	return err
}
fmt.Println(version.Value.ID, version.Value.State)

Java

import com.getlingara.client.model.VersionDetail;

VersionDetail version = client.getApiVersion("2026-09-knowing-tenpounder").body();
System.out.println(version.getId() + " " + version.getState());

Kotlin

val version = client.getApiVersion("2026-09-knowing-tenpounder").body
println("${version.id} ${version.state}")

Ruby

version = client.get_api_version(version_id).value
puts "#{version.id}: #{version.state}#{", sunset #{version.sunset_at}" if version.sunset_at}"

PHP

// Needs no token: a client built without credentials can call it.
$version = $client->getApiVersion($versionId)->value;
echo $version->getId(), ' is ', $version->getState()->value, "\n";

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

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