API バージョンの取得

API バージョン 2026-10-affable-towhee

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

1 つの API バージョンを、完全な history、summary（英語）、spec とともに返します。spec.url のドキュメントがこのバージョンのものになるのは、Lingara-Version ヘッダーにその ID を指定してリクエストした場合だけです。spec.sha256 は凍結されたドキュメントのハッシュで、バージョンがまだ開発中の間は null です。不明な ID には 404 を返します。トークンは不要です。レスポンスは 1 時間キャッシュされることがあります。

スコープ 認証は不要です

パラメーター

Lingara-Versionheaderstring任意: このリクエストに応答する API バージョン。指定がない場合、アクセストークンはそのクライアントに固定されたバージョンを、トークンのないリクエストは現行バージョンを受け取ります。開発中のバージョンには、ここで指定した場合にのみアクセスできます。不明なバージョンにはコード api_version_unknown とともに 400 を返します。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";

ライブラリを使いたい場合は、ライブラリのセクションをご覧ください。

翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。