Kry 'n API-weergawe

API-weergawe 2026-10-affable-towhee

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

Gee een API-weergawe terug met sy volledige history, sy summary (in Engels) en sy spec. Die dokument by spec.url is net dié weergawe s'n wanneer dit versoek word met die Lingara-Version-kopskrif op sy id gestel. spec.sha256 is die hash van sy bevrore dokument, en is null terwyl die weergawe nog in ontwikkeling is. 'n Onbekende id antwoord 404. Geen token is nodig nie. Antwoorde kan vir 'n uur gekas word.

Omvange Geen verifikasie nodig nie

Parameters

Lingara-Versionheaderstringopsioneel: Die API-weergawe waaronder hierdie versoek beantwoord word. Daarsonder kry 'n toegangstoken die weergawe waaraan sy kliënt gekoppel is, en 'n versoek sonder 'n token kry die huidige weergawe. Die weergawe wat nog ontwikkel word, is slegs bereikbaar deur dit hier te noem. 'n Onbekende weergawe gee 400 met kode api_version_unknown. GET /v1/versions lys die weergawes.
idpathstringverplig

Antwoorde

200 Die API-weergawe

idstringverplig

stateVersionStateverplig

ltsbooleanverplig

minted_atstringverplig

sunset_atstring | nullverplig

summarystring | nullverplig

historyarray of VersionHistoryEntryverplig

stateVersionStateverplig
atstringverplig

specVersionSpecverplig

urlstringverplig
sha256string | nullverplig

asyncapiVersionSpecverplig

urlstringverplig
sha256string | nullverplig

Foute

410application/json: Die API-weergawe waaronder hierdie versoek beantwoord word, is gestaak. Stuur 'n ondersteunde weergawe in Lingara-Version, of koppel die kliënt aan 'n ander weergawe.
4XXapplication/json: Die versoek is geweier. code sê hoekom, en error sê dit in woorde.
503application/json · text/plain: Die diens is tydelik onbeskikbaar; probeer weer na die aantal sekondes in Retry-After. Tydens onderhoud is die liggaam gewone teks eerder as die foutomhulsel.
5XXapplication/json: Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

codestringverplig: Waarom die versoek geweier is, as 'n stabiele kode om op te vertak: byvoorbeeld insufficient_scope (403), rate_limited (429) en, vir 'n gemeterde kliënt, spend_cap_reached (402) en metered_billing_inactive (402).
errorstringverplig

Voorbeeld

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

Verkies jy 'n biblioteek? Sien die Biblioteke-afdeling.

Indien 'n vertaling en die Engelse verwysing verskil, is die Engelse verwysing korrek.