دریافت یک نسخهٔ API

پارامترها

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الزامی

نمونه

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

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

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)

import com.getlingara.client.model.VersionDetail;

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

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

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

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

کتابخانه را ترجیح می‌دهید؟ بخش کتابخانه‌ها را ببینید.