Ottieni una versione dell'API

Versione API 2026-10-affable-towhee

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

Restituisce una versione dell'API con la sua history completa, il suo summary (in inglese) e la sua spec. Il documento a spec.url è quello di questa versione solo se richiesto con l'intestazione Lingara-Version impostata sul suo id. spec.sha256 è l'hash del suo documento congelato ed è null finché la versione è ancora in sviluppo. Un id sconosciuto risponde 404. Non serve alcun token. Le risposte possono essere memorizzate nella cache per un'ora.

Scope Nessuna autenticazione richiesta

Parametri

Lingara-Versionheaderstringfacoltativo: La versione dell'API con cui rispondere a questa richiesta. Senza di essa, un token di accesso riceve la versione a cui è associato il suo client e una richiesta senza token riceve la versione corrente. La versione ancora in sviluppo si raggiunge solo indicandola qui. Una versione sconosciuta risponde 400 con il codice api_version_unknown. GET /v1/versions elenca le versioni.
idpathstringobbligatorio

Risposte

200 La versione dell'API

idstringobbligatorio

stateVersionStateobbligatorio

ltsbooleanobbligatorio

minted_atstringobbligatorio

sunset_atstring | nullobbligatorio

summarystring | nullobbligatorio

historyarray of VersionHistoryEntryobbligatorio

stateVersionStateobbligatorio
atstringobbligatorio

specVersionSpecobbligatorio

urlstringobbligatorio
sha256string | nullobbligatorio

asyncapiVersionSpecobbligatorio

urlstringobbligatorio
sha256string | nullobbligatorio

Errori

410application/json: La versione dell'API con cui si risponde a questa richiesta è stata dismessa. Invia una versione supportata in Lingara-Version, oppure associa il client a un'altra versione.
4XXapplication/json: La richiesta è stata rifiutata. code dice il motivo, e error lo spiega a parole.
503application/json · text/plain: Il servizio è temporaneamente non disponibile; riprova dopo il numero di secondi indicato in Retry-After. Durante la manutenzione il corpo è testo semplice anziché l'envelope di errore.
5XXapplication/json: La richiesta è stata rifiutata. code dice il motivo, e error lo spiega a parole.

codestringobbligatorio: Perché la richiesta è stata rifiutata, come codice stabile su cui diramare la logica: per esempio insufficient_scope (403), rate_limited (429) e, per un client con fatturazione a consumo, spend_cap_reached (402) e metered_billing_inactive (402).
errorstringobbligatorio

Esempio

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

Preferisci una libreria? Vedi la sezione Librerie.

In caso di discrepanza tra una traduzione e il riferimento in inglese, fa fede il riferimento in inglese.