API-versies weergeven

Parameters

Lingara-Versionheaderstringoptioneel

De API-versie waaronder dit verzoek wordt beantwoord. Zonder deze krijgt een toegangstoken de versie waaraan zijn client is gekoppeld, en een verzoek zonder token de huidige versie. De versie die nog in ontwikkeling is, bereik je alleen door die hier te noemen. Een onbekende versie geeft 400 met code api_version_unknown. GET /v1/versions toont de versies.

Antwoorden

200 Alle API-versies

currentstring | nullverplicht

developmentstring | nullverplicht

versionsarray of VersionSummaryverplicht

idstringverplicht

stateVersionStateverplicht

ltsbooleanverplicht

minted_atstringverplicht

sunset_atstring | nullverplicht

Fouten

410application/json

De API-versie waaronder dit verzoek wordt beantwoord, is stopgezet. Stuur een ondersteunde versie mee in Lingara-Version, of koppel de client aan een andere versie.

4XXapplication/json

Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.

503application/json · text/plain

De dienst is tijdelijk niet beschikbaar; probeer het opnieuw na het aantal seconden in Retry-After. Tijdens onderhoud is de body platte tekst in plaats van de foutenvelop.

5XXapplication/json

Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.

codestringverplicht

Waarom het verzoek is geweigerd, als stabiele code om op te vertakken: bijvoorbeeld insufficient_scope (403), rate_limited (429) en, voor een client met verbruiksafrekening, spend_cap_reached (402) en metered_billing_inactive (402).

errorstringverplicht

Voorbeeld

curl "https://api.getlingara.com/v1/versions"

const list = await client.listApiVersions();
console.log("current:", list.current);
for (const v of list.versions) console.log(v.id, v.state);

let list = client.list_api_versions().await?;
println!("current: {}", list.current.as_deref().unwrap_or("(none)"));
for version in &list.versions {
    println!("{} {:?}", version.id, version.state);
}

versions, err := client.ListAPIVersions(ctx)
if err != nil {
	return err
}
for _, v := range versions.Value.Versions {
	fmt.Println(v.ID, v.State, v.Lts)
}

import com.getlingara.client.model.VersionSummary;

for (VersionSummary version : client.listApiVersions().body().getVersions()) {
  System.out.println(version.getId() + " " + version.getState() + " " + version.getLts());
}

for (version in client.listApiVersions().body.versions) {
    println("${version.id} ${version.state} ${version.lts}")
}

list = client.list_api_versions.value
puts "current: #{list.current}"
list.versions.each { |version| puts "#{version.id} #{version.state}" }

// Needs no token: a client built without credentials can call it.
$versions = $client->listApiVersions()->value;
echo 'current: ', $versions->getCurrent(), "\n";
foreach ($versions->getVersions() as $version) {
    echo $version->getId(), ' ', $version->getState()->value, "\n";
}

Liever een bibliotheek? Zie de sectie Bibliotheken.