Eine API-Version abrufen

API-Version 2026-10-affable-towhee

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

Gibt eine API-Version mit ihrer vollständigen history, ihrer summary (auf Englisch) und ihrer spec zurück. Das Dokument unter spec.url ist nur dann das dieser Version, wenn es mit dem Header Lingara-Version auf ihre ID gesetzt angefordert wird. spec.sha256 ist der Hash ihres eingefrorenen Dokuments und ist null, solange die Version noch in Entwicklung ist. Eine unbekannte ID ergibt 404. Kein Token nötig. Antworten dürfen eine Stunde lang zwischengespeichert werden.

Scopes Keine Authentifizierung erforderlich

Parameter

Lingara-Versionheaderstringoptional: Die API-Version, unter der diese Anfrage beantwortet wird. Ohne sie erhält ein Zugriffstoken die Version, an die sein Client gebunden ist, und eine Anfrage ohne Token die aktuelle Version. Die Version in Entwicklung ist nur erreichbar, indem man sie hier nennt. Eine unbekannte Version wird mit 400 und dem Code api_version_unknown beantwortet. GET /v1/versions listet die Versionen auf.
idpathstringerforderlich

Antworten

200 Die API-Version

idstringerforderlich

stateVersionStateerforderlich

ltsbooleanerforderlich

minted_atstringerforderlich

sunset_atstring | nullerforderlich

summarystring | nullerforderlich

historyarray of VersionHistoryEntryerforderlich

stateVersionStateerforderlich
atstringerforderlich

specVersionSpecerforderlich

urlstringerforderlich
sha256string | nullerforderlich

asyncapiVersionSpecerforderlich

urlstringerforderlich
sha256string | nullerforderlich

Fehler

410application/json: Die API-Version, unter der diese Anfrage beantwortet wird, wurde eingestellt. Sende eine unterstützte Version in Lingara-Version oder binde den Client an eine andere Version.
4XXapplication/json: Die Anfrage wurde abgelehnt. code nennt den Grund, und error beschreibt ihn in Worten.
503application/json · text/plain: Der Dienst ist vorübergehend nicht verfügbar; versuche es nach der in Retry-After angegebenen Anzahl Sekunden erneut. Während Wartungsarbeiten ist der Body reiner Text statt des Fehlerumschlags.
5XXapplication/json: Die Anfrage wurde abgelehnt. code nennt den Grund, und error beschreibt ihn in Worten.

codestringerforderlich: Warum die Anfrage abgelehnt wurde, als stabiler Code, nach dem du verzweigen kannst: zum Beispiel insufficient_scope (403), rate_limited (429) und, bei einem nutzungsbasiert abgerechneten Client, spend_cap_reached (402) und metered_billing_inactive (402).
errorstringerforderlich

Beispiel

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

Lieber eine Bibliothek? Siehe den Bereich Bibliotheken.

Weichen eine Übersetzung und die englische Referenz voneinander ab, ist die englische Referenz maßgeblich.