Ambil dokumen event
Versi API 2026-10-affable-towhee
get https://api.getlingara.com/v1/asyncapi.json
Mengembalikan dokumen AsyncAPI yang menjelaskan event Lingara, untuk versi API yang digunakan untuk menjawab permintaan: versi yang disebut di Lingara-Version, atau jika tidak, versi saat ini. Tidak perlu token.
Cakupan Tidak perlu autentikasi
Parameter
Lingara-Versionheaderstringopsional- Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapatkan versi yang disematkan pada kliennya, dan permintaan tanpa token mendapatkan versi saat ini. Versi yang masih dalam pengembangan hanya dapat dicapai dengan menyebutkannya di sini. Versi yang tidak dikenal dijawab
400dengan kodeapi_version_unknown.GET /v1/versionsmencantumkan versi-versinya.
Respons
200 Dokumen AsyncAPI
Galat
410application/json- Versi API yang digunakan untuk menjawab permintaan ini telah dihentikan. Kirim versi yang didukung di
Lingara-Version, atau sematkan klien ke versi lain. 4XXapplication/json- Permintaan ditolak.
codemenyebutkan alasannya, danerrormenjelaskannya dengan kata-kata. 503application/json · text/plain- Layanan sementara tidak tersedia; coba lagi setelah jumlah detik di
Retry-After. Selama pemeliharaan, isi respons berupa teks biasa, bukan amplop galat.
codestringwajibAlasan permintaan ditolak, sebagai kode tetap untuk percabangan: misalnya
insufficient_scope(403),rate_limited(429) dan, untuk klien dengan penagihan per pemakaian,spend_cap_reached(402) danmetered_billing_inactive(402).errorstringwajib
Contoh
curl "https://api.getlingara.com/v1/asyncapi.json"Jika terjemahan berbeda dengan referensi berbahasa Inggris, referensi berbahasa Inggris yang berlaku.