Senaraikan versi API

Parameter

Lingara-Versionheaderstringpilihan

Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapat versi yang dipautkan kepada kliennya, dan permintaan tanpa token mendapat versi semasa. Versi yang masih dalam pembangunan hanya boleh dicapai dengan menamakannya di sini. Versi yang tidak dikenali dijawab 400 dengan kod api_version_unknown. GET /v1/versions menyenaraikan versi.

Respons

200 Setiap versi API

currentstring | nullwajib

developmentstring | nullwajib

versionsarray of VersionSummarywajib

idstringwajib

stateVersionStatewajib

ltsbooleanwajib

minted_atstringwajib

sunset_atstring | nullwajib

Ralat

410application/json

Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Hantar versi yang disokong dalam Lingara-Version, atau pautkan klien kepada versi lain.

4XXapplication/json

Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

503application/json · text/plain

Perkhidmatan tidak tersedia buat sementara waktu; cuba lagi selepas bilangan saat dalam Retry-After. Semasa penyelenggaraan, kandungan ialah teks biasa dan bukan sampul ralat.

5XXapplication/json

Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

codestringwajib

Sebab permintaan ditolak, sebagai kod stabil untuk dijadikan asas percabangan: contohnya insufficient_scope (403), rate_limited (429) dan, bagi klien bermeter, spend_cap_reached (402) dan metered_billing_inactive (402).

errorstringwajib

Contoh

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

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

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)
}

import com.getlingara.client.model.VersionSummary;

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

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

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

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

Lebih suka pustaka? Lihat bahagian Pustaka.