الحصول على حصتك المتبقية
إصدار API 2026-10-affable-towhee
get https://api.getlingara.com/v1/usage
يسرد كل حصة تنطبق على حسابك، مع مقدار ما استُخدم منها وموعد إعادة تعيينها.
النطاقات usage:read
المعاملات
Lingara-Versionheaderstringاختياري- إصدار API الذي يُجاب عن هذا الطلب به. بدونه، يحصل رمز الوصول على الإصدار الذي رُبط به عميله، ويحصل الطلب الذي لا رمز مميز فيه على الإصدار الحالي. لا يمكن الوصول إلى الإصدار الذي لا يزال قيد التطوير إلا بذكره هنا. الإصدار غير المعروف يُجاب عنه بـ
400مع الرمزapi_version_unknown. يسردGET /v1/versionsالإصدارات.
الاستجابات
200 حصتك
allowancearray of AllowanceRowمطلوبfeaturestringمطلوبwindowstringمطلوبlimitintegerمطلوبusedintegerمطلوبremainingintegerمطلوبreset_atinteger | nullاختياري
ledgerUsageLedger | nullاختيارياستدعاءات هذا العميل ووحداته منذ منتصف الليل بتوقيت UTC في اليوم الأول من الشهر. لا يظهر إلا لعميل محسوب بالاستهلاك، لا تستهلك استدعاءاته أي حصة. قد يتأخر عن آخر استدعاء لك بما يصل إلى خمس ثوانٍ.
sincestringمطلوبcallsintegerمطلوبunitsintegerمطلوب
الأخطاء
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مطلوب
مثال
إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.