> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# لوحة استخدام API

> لا توجد حاليًا لوحة استخدام مخصصة داخل التطبيق — إليك ما هو ظاهر فعليًا في الواجهة اليوم، وأين تعيش أرقام الاستخدام الحقيقية بدلًا من ذلك.

<Warning>
  وجد التحقق المباشر لهذه الصفحة أنه **لا توجد حاليًا لوحة استخدام مخصصة لـ API في التطبيق.** توثّق هذه الصفحة هذه الفجوة بصدق بدلًا من وصف شاشة غير موجودة. إذا كنت بحاجة إلى أرقام الاستخدام اليوم، استخدم نقاط نهاية الاستخدام الخاصة بـ Management API مباشرة — راجع [ذات صلة](#ذات-صلة) أدناه.
</Warning>

## ما تم التحقق منه

* قسم **Developer** في الشريط الجانبي يحتوي على عنصر واحد فقط، **API** (‏`/api/keys`) — لا يوجد عنصر ثانٍ باسم "Usage" بجانبه.
* الانتقال مباشرة إلى `/api/usage` يعرض صفحة 404 الخاصة بالتطبيق ("Page not found — The page you're looking for doesn't exist or has moved").
* [صفحة API Keys](/ar/api-keys/creating-and-managing-keys) نفسها — الصفحة الوحيدة تحت Developer → API الموجودة فعلًا — تسرد **Name** و**API Key** و**Created On** و**Created By** و**Expires On** لكل مفتاح. لا تُظهر عدد الاستخدام أو الطلبات في أي مكان في ذلك الجدول، رغم أن نموذج البيانات الأساسي (‏`ApiKeyItem.usage_count`) يحمل بالفعل عدد طلبات مدى الحياة لكل مفتاح — إنه ببساطة غير معروض في هذا الجدول.
* مكوّن داخلي مشترك (‏`EnterpriseLockedCard`) يحتوي على تعليق برمجي يصف نفسه بأنه البديل "المقيد بخطة Enterprise" الظاهر في "صفحات Developer > API (‏Keys **وUsage**)" — صياغة تُوحي بأن صفحة Usage كانت مخططًا لها. إنها غير مربوطة بأي مسار اليوم — الصفحة الوحيدة التي تستورد هذا المكوّن وتعرضه فعليًا هي صفحة Keys نفسها، حيث تُقيّد إنشاء المفاتيح للحسابات التي لا تملك وصول Management API.

مجتمعة، تبدو هذه صفحة صُممت من أجلها بنية أساسية لكنها لم تُشحن قط، وليست صفحة أُزيلت — يستحق الأمر التأكد من فريق الهندسة إذا كنت تتوقع العثور عليها.

## أين تعيش بيانات الاستخدام فعليًا

إلى أن تظهر لوحة داخل التطبيق، الطريقة الوحيدة لرؤية استخدام Management API هي استدعاء نقاط نهاية الاستخدام مباشرة، باستخدام نفس رمز وصول OAuth الذي تستخدمه للوحة التحكم نفسها (وليس مفتاح Management API):

| نقطة النهاية                                                                                   | ما تُعيده                                                                         |
| ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [`GET /console/usage/`](/ar/api-reference/management-api/tokens/usage-stats)                   | إجمالي / ناجح / فاشل من عدد الطلبات لبيئة ما، عبر نافذة يوم/أسبوع/شهر/سنة متجددة. |
| [`GET /console/usage/daily/`](/ar/api-reference/management-api/tokens/usage-daily)             | نفس الأرقام مُقسّمة حسب اليوم، لرسم اتجاه بنفسك.                                  |
| [`GET /console/usage/by-endpoint/`](/ar/api-reference/management-api/tokens/usage-by-endpoint) | تفصيل حسب مسار API فردي.                                                          |

<Note>
  هذه الأرقام مُجمّعة **لكل بيئة** (‏`sandbox`، و`live`، و`zapier`، و`mcp`)، عبر كل مفتاح يشارك تلك البيئة — وليس لكل مفتاح على حدة. عدد طلبات مفتاح واحد مدى الحياة هو حقل `usage_count` الذي تُعيده [`GET /console/token/`](/ar/api-reference/management-api/tokens/create#listing-existing-tokens)، والذي — بحسب الفجوة المذكورة أعلاه — غير معروض حاليًا في أي مكان في لوحة التحكم، فقط في استجابة API الخام.
</Note>

## ذات صلة

* [إحصاءات الاستخدام](/ar/api-reference/management-api/tokens/usage-stats)، و[الاستخدام اليومي](/ar/api-reference/management-api/tokens/usage-daily)، و[الاستخدام حسب نقطة النهاية](/ar/api-reference/management-api/tokens/usage-by-endpoint) — نقاط النهاية التقنية التي يمكن استدعاؤها مباشرة إلى أن تُشحن لوحة داخل التطبيق.
* [إنشاء مفاتيح API وإدارتها](/ar/api-keys/creating-and-managing-keys) — الصفحة الوحيدة تحت Developer → API الموجودة فعلًا اليوم.