Lingara Lingara Mwongozo Miongozo API Maktaba Programu Unda Programu ya wavuti
Lugha: Kiswahili

Pata toleo moja la API

Toleo la API 2026-10-affable-towhee

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

Hurudisha toleo moja la API pamoja na history yake kamili, summary yake (kwa Kiingereza) na spec yake. Hati iliyo kwenye spec.url ni ya toleo hili tu inapoombwa kwa kichwa Lingara-Version kilichowekwa kuwa kitambulisho chake. spec.sha256 ni hashi ya hati yake iliyogandishwa, na ni null wakati toleo bado liko katika uundaji. Kitambulisho kisichojulikana hujibu 404. Hakuna tokeni inayohitajika. Majibu yanaweza kuhifadhiwa kwenye akiba kwa saa moja.

Wigo Hakuna uthibitishaji unaohitajika

Vigezo

Lingara-Versionheaderstringsi lazima
Toleo la API la kutumia kujibu ombi hili. Bila hilo, tokeni ya ufikiaji hupata toleo ambalo mteja wake ameunganishwa nalo, na ombi lisilo na tokeni hupata toleo la sasa. Toleo ambalo bado linaendelezwa linafikiwa tu kwa kulitaja hapa. Toleo lisilojulikana hujibiwa 400 pamoja na msimbo api_version_unknown. GET /v1/versions huorodhesha matoleo.
idpathstringinahitajika

Majibu

200 Toleo la API

idstringinahitajika
stateVersionStateinahitajika
ltsbooleaninahitajika
minted_atstringinahitajika
sunset_atstring | nullinahitajika
summarystring | nullinahitajika
historyarray of VersionHistoryEntryinahitajika
stateVersionStateinahitajika
atstringinahitajika
specVersionSpecinahitajika
urlstringinahitajika
sha256string | nullinahitajika
asyncapiVersionSpecinahitajika
urlstringinahitajika
sha256string | nullinahitajika

Hitilafu

410application/json
Toleo la API linalotumika kujibu ombi hili limesitishwa. Tuma toleo linalotumika katika Lingara-Version, au unganisha mteja na toleo lingine.
4XXapplication/json
Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.
503application/json · text/plain
Huduma haipatikani kwa muda; jaribu tena baada ya idadi ya sekunde zilizo katika Retry-After. Wakati wa matengenezo, mwili wa jibu ni maandishi ya kawaida badala ya bahasha ya hitilafu.
5XXapplication/json
Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.
codestringinahitajika

Sababu ya ombi kukataliwa, kama msimbo thabiti wa kufanyia maamuzi: kwa mfano insufficient_scope (403), rate_limited (429) na, kwa mteja anayetozwa kwa matumizi, spend_cap_reached (402) na metered_billing_inactive (402).

errorstringinahitajika

Mfano

Lugha ya mfano wa msimbo

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

Go

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

Unapendelea maktaba? Tazama sehemu ya Maktaba.

Ikiwa tafsiri na marejeleo ya Kiingereza yanatofautiana, marejeleo ya Kiingereza ndiyo sahihi.