Dapatkan satu versi API

Versi API 2026-10-affable-towhee

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

Mengembalikan satu versi API dengan history lengkapnya, summary-nya (dalam bahasa Inggris), dan spec-nya. Dokumen di spec.url adalah milik versi ini hanya jika diminta dengan header Lingara-Version yang diisi id-nya. spec.sha256 adalah hash dokumennya yang dibekukan, dan bernilai null selama versi masih dalam pengembangan. Id yang tidak dikenal menjawab 404. Tidak perlu token. Respons boleh di-cache selama satu jam.

Cakupan Tidak perlu autentikasi

Parameter

Lingara-Versionheaderstringopsional: Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapatkan versi yang disematkan pada kliennya, dan permintaan tanpa token mendapatkan versi saat ini. Versi yang masih dalam pengembangan hanya dapat dicapai dengan menyebutkannya di sini. Versi yang tidak dikenal dijawab 400 dengan kode api_version_unknown. GET /v1/versions mencantumkan versi-versinya.
idpathstringwajib

Respons

200 Versi API

idstringwajib

stateVersionStatewajib

ltsbooleanwajib

minted_atstringwajib

sunset_atstring | nullwajib

summarystring | nullwajib

historyarray of VersionHistoryEntrywajib

stateVersionStatewajib
atstringwajib

specVersionSpecwajib

urlstringwajib
sha256string | nullwajib

asyncapiVersionSpecwajib

urlstringwajib
sha256string | nullwajib

Galat

410application/json: Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Kirim versi yang didukung di Lingara-Version, atau sematkan klien ke versi lain.
4XXapplication/json: Permintaan ditolak. code menyebutkan alasannya, dan error menjelaskannya dengan kata-kata.
503application/json · text/plain: Layanan sementara tidak tersedia; coba lagi setelah jumlah detik di Retry-After. Selama pemeliharaan, isi respons berupa teks biasa, bukan amplop galat.
5XXapplication/json: Permintaan ditolak. code menyebutkan alasannya, dan error menjelaskannya dengan kata-kata.

codestringwajib: Alasan permintaan ditolak, sebagai kode tetap untuk percabangan: misalnya insufficient_scope (403), rate_limited (429) dan, untuk klien dengan penagihan per pemakaian, spend_cap_reached (402) dan metered_billing_inactive (402).
errorstringwajib

Contoh

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";

Lebih suka pustaka? Lihat bagian Pustaka.

Jika terjemahan berbeda dengan referensi berbahasa Inggris, referensi berbahasa Inggris yang berlaku.