الحصول على مستند الأحداث

إصدار API 2026-10-affable-towhee

get https://api.getlingara.com/v1/asyncapi.json

يعيد مستند AsyncAPI الذي يصف أحداث Lingara، لإصدار API الذي يُجاب عن الطلب به: الإصدار المذكور في Lingara-Version، وإلا فالإصدار الحالي. لا حاجة إلى رمز مميز.

النطاقات لا تلزم مصادقة

المعاملات

Lingara-Versionheaderstringاختياري: إصدار API الذي يُجاب عن هذا الطلب به. بدونه، يحصل رمز الوصول على الإصدار الذي رُبط به عميله، ويحصل الطلب الذي لا رمز مميز فيه على الإصدار الحالي. لا يمكن الوصول إلى الإصدار الذي لا يزال قيد التطوير إلا بذكره هنا. الإصدار غير المعروف يُجاب عنه بـ 400 مع الرمز api_version_unknown. يسرد GET /v1/versions الإصدارات.

الاستجابات

200 مستند AsyncAPI

الأخطاء

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مطلوب

مثال

curl "https://api.getlingara.com/v1/asyncapi.json"

تفضّل مكتبة؟ راجع قسم المكتبات.

إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.