الحصول على إصدار من الواجهة البرمجية

المعاملات

Lingara-Versionheaderstringاختياري

إصدار API الذي يُجاب عن هذا الطلب به. بدونه، يحصل رمز الوصول على الإصدار الذي رُبط به عميله، ويحصل الطلب الذي لا رمز مميز فيه على الإصدار الحالي. لا يمكن الوصول إلى الإصدار الذي لا يزال قيد التطوير إلا بذكره هنا. الإصدار غير المعروف يُجاب عنه بـ 400 مع الرمز api_version_unknown. يسرد GET /v1/versions الإصدارات.

idpathstringمطلوب

الاستجابات

200 إصدار الواجهة البرمجية

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

تفضّل مكتبة؟ راجع قسم المكتبات.