دریافت این سند
نسخهٔ API 2026-10-affable-towhee
get https://api.getlingara.com/v1/openapi.json
این توصیف API را بهصورت JSON برمیگرداند، برای نسخهٔ APIای که درخواست با آن پاسخ داده میشود: نسخهای که در Lingara-Version آمده، وگرنه نسخهٔ فعلی. به توکن نیازی نیست.
دامنههای دسترسی نیازی به احراز هویت نیست
پارامترها
Lingara-Versionheaderstringاختیاری- نسخهٔ APIای که این درخواست با آن پاسخ داده میشود. بدون آن، توکن دسترسی نسخهای را میگیرد که کلاینتش به آن متصل است، و درخواستی بدون توکن نسخهٔ فعلی را میگیرد. به نسخهای که هنوز در حال توسعه است فقط با نامبردن آن در اینجا میتوان رسید. نسخهٔ ناشناخته با
400و کدapi_version_unknownپاسخ داده میشود.GET /v1/versionsنسخهها را فهرست میکند.
پاسخها
200 سند OpenAPI
خطاها
410application/json- نسخهٔ APIای که این درخواست با آن پاسخ داده میشود متوقف شده است. یک نسخهٔ پشتیبانیشده را در
Lingara-Versionبفرستید، یا کلاینت را به نسخهٔ دیگری متصل کنید. 4XXapplication/json- درخواست رد شد.
codeدلیل آن را مشخص میکند وerrorآن را با کلمات بیان میکند. 503application/json · text/plain- سرویس موقتاً در دسترس نیست؛ پس از تعداد ثانیههای ذکرشده در
Retry-Afterدوباره تلاش کنید. در زمان نگهداری، بدنهٔ پاسخ بهجای پوشش خطا، متن ساده است.
codestringالزامیدلیل رد شدن درخواست، بهصورت کدی ثابت که میتوان بر اساس آن تصمیم گرفت: برای نمونه
insufficient_scope(403)،rate_limited(429) و، برای یک کلاینت مصرفی،spend_cap_reached(402) وmetered_billing_inactive(402).errorstringالزامی
نمونه
اگر ترجمه با مرجع انگلیسی تفاوت داشته باشد، مرجع انگلیسی معتبر است.