عرض إصدارات الواجهة البرمجية

إصدار API 2026-10-affable-towhee

get https://api.getlingara.com/v1/versions

يعرض كل إصدار من الواجهة البرمجية بترتيب إنشائه، مع state الخاصة به، ووقت إنشائه، وتاريخ انتهاء دعمه بعد إهماله. current هو أحدث إصدار مدعوم أو طويل الأمد (LTS)، وdevelopment هو الإصدار الذي لا يزال قيد التطوير؛ وكلاهما null إلى أن يوجد إصدار كهذا. لا حاجة إلى رمز مميز. يمكن تخزين الاستجابات مؤقتًا لمدة ساعة.

النطاقات لا تلزم مصادقة

المعاملات

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

الاستجابات

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

currentstring | nullمطلوب

developmentstring | nullمطلوب

versionsarray of VersionSummaryمطلوب

idstringمطلوب
stateVersionStateمطلوب
ltsbooleanمطلوب
minted_atstringمطلوب
sunset_atstring | 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"

TypeScript

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

Rust

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

Java

import com.getlingara.client.model.VersionSummary;

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

Kotlin

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

Ruby

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

PHP

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

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

إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.