ទទួលកំណែ API មួយ

កំណែ API 2026-10-affable-towhee

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

ត្រឡប់កំណែ API មួយ ជាមួយ history ពេញលេញ summary (ជាភាសាអង់គ្លេស) និង spec របស់វា។ ឯកសារនៅ spec.url ជារបស់កំណែនេះ លុះត្រាតែស្នើដោយកំណត់ក្បាល Lingara-Version ជា id របស់វា។ spec.sha256 គឺជា hash នៃឯកសារដែលបានបង្កករបស់វា ហើយជា null ខណៈកំណែនៅតែកំពុងអភិវឌ្ឍ។ id ដែលមិនស្គាល់ឆ្លើយតប 404។ មិនត្រូវការថូខឹនទេ។ ការឆ្លើយតបអាចត្រូវបានរក្សាទុកក្នុងឃ្លាំងសម្ងាត់រយៈពេលមួយម៉ោង។

វិសាលភាព មិនត្រូវការការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវទេ

ប៉ារ៉ាម៉ែត្រ

Lingara-Versionheaderstringស្រេចចិត្ត: កំណែ API ដែលត្រូវប្រើឆ្លើយសំណើនេះ។ បើគ្មានវាទេ token ចូលប្រើទទួលបានកំណែដែលម៉ាស៊ីនភ្ញៀវរបស់វាត្រូវបានភ្ជាប់ ហើយសំណើដែលគ្មាន token ទទួលបានកំណែបច្ចុប្បន្ន។ កំណែដែលកំពុងអភិវឌ្ឍអាចចូលដល់បានតែដោយដាក់ឈ្មោះវានៅទីនេះប៉ុណ្ណោះ។ កំណែដែលមិនស្គាល់ឆ្លើយតប 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ចាំបាច់

ឧទាហរណ៍

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

ចូលចិត្តបណ្ណាល័យមែនទេ? សូមមើលផ្នែកបណ្ណាល័យ។

ប្រសិនបើការបកប្រែ និងឯកសារយោងជាភាសាអង់គ្លេសខុសគ្នា ឯកសារយោងជាភាសាអង់គ្លេសគឺជាឯកសារដែលត្រឹមត្រូវ។