Λήψη μιας έκδοσης API

Παράμετροι

Lingara-Versionheaderstringπροαιρετικό

Η έκδοση API με την οποία απαντάται αυτό το αίτημα. Χωρίς αυτήν, ένα token πρόσβασης παίρνει την έκδοση στην οποία είναι δεσμευμένος ο πελάτης του και ένα αίτημα χωρίς token παίρνει την τρέχουσα έκδοση. Η έκδοση που βρίσκεται ακόμη υπό ανάπτυξη είναι προσβάσιμη μόνο αν την ονομάσετε εδώ. Μια άγνωστη έκδοση απαντάται με 400 και κωδικό api_version_unknown. Το GET /v1/versions παραθέτει τις εκδόσεις.

idpathstringυποχρεωτικό

Αποκρίσεις

200 Η έκδοση API

idstringυποχρεωτικό

stateVersionStateυποχρεωτικό

ltsbooleanυποχρεωτικό

minted_atstringυποχρεωτικό

sunset_atstring | nullυποχρεωτικό

summarystring | nullυποχρεωτικό

historyarray of VersionHistoryEntryυποχρεωτικό

stateVersionStateυποχρεωτικό

atstringυποχρεωτικό

specVersionSpecυποχρεωτικό

urlstringυποχρεωτικό

sha256string | nullυποχρεωτικό

asyncapiVersionSpecυποχρεωτικό

urlstringυποχρεωτικό

sha256string | nullυποχρεωτικό

Σφάλματα

410application/json

Η έκδοση API με την οποία απαντάται αυτό το αίτημα έχει καταργηθεί. Στείλτε μια υποστηριζόμενη έκδοση στο Lingara-Version ή συνδέστε τον πελάτη με άλλη έκδοση.

4XXapplication/json

Το αίτημα απορρίφθηκε. Το code λέει γιατί και το error το εξηγεί με λόγια.

503application/json · text/plain

Η υπηρεσία δεν είναι προσωρινά διαθέσιμη· δοκιμάστε ξανά μετά τον αριθμό δευτερολέπτων στο Retry-After. Κατά τη συντήρηση, το σώμα είναι απλό κείμενο αντί για τον φάκελο σφάλματος.

5XXapplication/json

Το αίτημα απορρίφθηκε. Το code λέει γιατί και το error το εξηγεί με λόγια.

codestringυποχρεωτικό

Γιατί απορρίφθηκε το αίτημα, ως σταθερός κωδικός για διακλάδωση: για παράδειγμα insufficient_scope (403), rate_limited (429) και, για πελάτη με χρέωση βάσει χρήσης, spend_cap_reached (402) και metered_billing_inactive (402).

errorstringυποχρεωτικό

Παράδειγμα

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

const version = await client.getApiVersion({ id: "2026-09-knowing-tenpounder" });
console.log(version.id, version.state, version.summary);

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)

import com.getlingara.client.model.VersionDetail;

VersionDetail version = client.getApiVersion("2026-09-knowing-tenpounder").body();
System.out.println(version.getId() + " " + version.getState());

val version = client.getApiVersion("2026-09-knowing-tenpounder").body
println("${version.id} ${version.state}")

version = client.get_api_version(version_id).value
puts "#{version.id}: #{version.state}#{", sunset #{version.sunset_at}" if version.sunset_at}"

// Needs no token: a client built without credentials can call it.
$version = $client->getApiVersion($versionId)->value;
echo $version->getId(), ' is ', $version->getState()->value, "\n";

Προτιμάτε μια βιβλιοθήκη; Δείτε την ενότητα Βιβλιοθήκες.