> ## 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.

# نظرة عامة على Management API

> Management API الكاملة من Scanova — كل ما هو متاح على management.scanova.io، بالإضافة إلى إنشاء رموز API (tokens) وإحصاءات الاستخدام.

**Management API** هي الواجهة البرمجية لكل ما يمكنك فعله في لوحة تحكم Scanova: إنشاء رموز QR وتحديثها، إدارة المجلدات والوسوم، قراءة العملاء المحتملين (leads) وإرسالات النماذج، سحب التحليلات، وإدارة المستخدمين المشاركين وأدوارهم. إنها مضيف منفصل عن بقية سطح API الخاص بـ Scanova، وله مخطط مصادقة خاص به.

<Note>
  تغطي هذه الصفحة البنية المعمارية التي تنطبق على كل نقطة نهاية في Management API. للاطلاع على القائمة الكاملة لنقاط النهاية، راجع الصفحات المرتبطة أسفل هذه الصفحة.
</Note>

## مضيفان، ومخططا مصادقة

هذا هو المصدر الأكثر شيوعًا للالتباس عند التكامل مع Management API، لذا اقرأ هذا القسم قبل كتابة أي كود.

|                  | إدارة الرموز (tokens)                                                                                                     | نقاط نهاية البيانات                                                                            |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------- |
| **المضيف**       | `qcg-api.scanova.io` (مضيف Scanova API المعتاد)                                                                           | `management.scanova.io` (مضيف مخصص)                                                            |
| **المصادقة**     | جلسة لوحة التحكم المعتادة الخاصة بك بعد تسجيل الدخول — رمز وصول OAuth، يُرسل بصيغة `Authorization: Bearer <access_token>` | مفتاح Management API الخام، يُرسل بصيغة `Authorization: <key>` — **بلا أي بادئة على الإطلاق**  |
| **نقاط النهاية** | `console/token/*`، `console/usage/*`                                                                                      | `qr/`، `qrcode/`، `folder/`، `tag/`، `lead/`، `forms/`، `analytics/`، `plans/`، `multi-users/` |
| **من يستدعيها**  | أنت، مرة واحدة، من واجهة خلفية أو أداة إدارة موثوقة، لإنشاء المفاتيح وإدارتها ومراقبتها                                   | تكاملك، مع كل طلب يقرأ أو يكتب بيانات رمز QR/مجلد/عميل محتمل/إلخ                               |

بعبارة أخرى: تُصادق بصفتك *نفسك* (تسجيل دخولك إلى لوحة التحكم) لإنشاء مفتاح Management API، وتُصادق بصفتك *المفتاح* لاستخدام Management API فعليًا.

<Warning>
  ترويسة `Authorization` الخاصة بمضيف البيانات تأخذ المفتاح الخام ولا شيء آخر. أي ترويسة تحتوي على أكثر من جزء مفصول بمسافة — `Bearer <key>`، أو `Token <key>`، أو أي شيء مشابه — تُرفض فورًا. أرسل بالضبط:

  ```
  Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
  ```

  هذا يعني أيضًا أن الطلبات إلى نقاط نهاية البيانات يجب أن تحمل ترويسة `Host` مضبوطة على `management.scanova.io` — إرسال المفتاح نفسه إلى `qcg-api.scanova.io` لن يُصادق.
</Warning>

## للبدء

<Steps>
  <Step title="أنشئ مفتاح Management API">
    أثناء تسجيل دخولك إلى لوحة تحكم Scanova، أنشئ مفتاحًا عبر [`POST /console/token/`](/ar/api-reference/management-api/tokens/create) (أو واجهة إدارة المفاتيح في لوحة التحكم، راجع [إنشاء مفاتيح API وإدارتها](/ar/api-keys/creating-and-managing-keys)). اختر `environment` — `sandbox` أو `live` أو `zapier` أو `mcp` — عند إنشائه؛ هذا الاختيار دائم لهذا المفتاح ويحدد حصة الخطة التي تُفحص مع كل طلب يقوم به المفتاح (انظر أدناه).
  </Step>

  <Step title="خزّن القيمة الخام للمفتاح">
    قيمة المفتاح التي تعيدها استدعاء الإنشاء هي المرة الوحيدة التي سترى فيها المفتاح كاملًا — خزّنه بأمان. لا توجد نقطة نهاية "لإظهاره" لاحقًا.
  </Step>

  <Step title="استدعِ نقاط نهاية البيانات">
    أرسل المفتاح كقيمة خام لترويسة `Authorization` إلى `management.scanova.io`، مثلًا [`GET /qr/`](/ar/api-reference/management-api/qr/list) لسرد رموز QR الخاصة بك.
  </Step>
</Steps>

## حصة الخطة

كل طلب إلى نقطة نهاية بيانات يفحص حصة خطة مرتبطة بـ `environment` الخاصة بالمفتاح:

| `environment`       | الحصة المفحوصة       | يتطلب أيضًا                                                   |
| :------------------ | :------------------- | :------------------------------------------------------------ |
| `live` أو `sandbox` | `MANAGEMENT_API`     | —                                                             |
| `zapier`            | `INTEGRATION_ZAPIER` | يجب أن تكون ترويسة `User-Agent` الخاصة بالطلب حرفيًا `zapier` |
| `mcp`               | `INTEGRATION_MCP`    | يجب أن تكون ترويسة `User-Agent` الخاصة بالطلب حرفيًا `mcp`    |

<Note>
  إذا أعاد طلب إلى مضيف البيانات الرمز `401` مع الرسالة **"Your plan does not have management API quota"** (أو ما يعادلها الخاص بـ Zapier/MCP)، فهذا يعني أن خطتك لا تمنح تلك الحصة. حاليًا، لا تتضمن خطة Pro القياسية الوصول إلى Management API — فقط خطط Free Trial وEnterprise وInternal تتضمنه. تواصل مع [support@scanova.io](mailto:support@scanova.io) إذا كنت تعتقد أن حسابك ينبغي أن يملك هذه الميزة.
</Note>

<Warning>
  `sandbox` مجرد مفهوم تصنيف وحصة فقط — إنه **ليس** بيئة اختبار معزولة. المفتاح المُنشأ بـ `environment: sandbox` يقرأ ويكتب نفس رموز QR والمجلدات والعملاء المحتملين الحقيقيين التي يستخدمها مفتاح `live`. لا تعتمد عليه لبيانات اختبار قابلة للتخلص منها.
</Warning>

مفتاح `zapier`/`mcp` يُصادق إضافيًا فقط عندما تتطابق ترويسة `User-Agent` الخاصة بالعميل المستدعي مع بيئته — مفتاح `zapier` يرفض الطلبات ما لم تكن `User-Agent: zapier`، وكذلك الأمر بالنسبة لـ `mcp`. يُطبَّق هذا بشكل مستقل عن فحص الحصة أعلاه.

## محتويات هذا القسم

<CardGroup cols={2}>
  <Card title="إنشاء رمز API" icon="key" href="/ar/api-reference/management-api/tokens/create">
    `POST /console/token/` — يولّد مفتاحًا جديدًا لبيئة مختارة.
  </Card>

  <Card title="إزالة رمز API" icon="trash" href="/ar/api-reference/management-api/tokens/remove">
    `DELETE /console/token/{key}/` — يُلغي مفتاحًا فورًا.
  </Card>

  <Card title="إحصاءات الاستخدام" icon="chart-line" href="/ar/api-reference/management-api/tokens/usage-stats">
    `GET /console/usage/` — أعداد الطلبات ضمن نافذة زمنية متحركة.
  </Card>

  <Card title="سرد رموز QR" icon="qrcode" href="/ar/api-reference/management-api/qr/list">
    `GET /qr/` — نقطة نهاية البيانات الأساسية التي تبدأ بها معظم عمليات التكامل.
  </Card>

  <Card title="إنشاء رمز QR" icon="qrcode" href="/ar/api-reference/management-api/qr/create">
    `POST /qr/` — نقطة نهاية البيانات الأساسية التي تبدأ بها معظم عمليات التكامل.
  </Card>
</CardGroup>

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

## ذات صلة

* [مقدمة مرجع API](/ar/api-reference/getting-started/introduction) — القسم الأصلي الذي تنتمي إليه هذه النظرة العامة.
* [إنشاء رمز API](/ar/api-reference/management-api/tokens/create) — أنشئ المفتاح الذي يُصادق عبره سطح هذه الـ API بأكمله.
* [سرد رموز QR](/ar/api-reference/management-api/qr/list) — نقطة نهاية البيانات الأساسية التي تبدأ بها معظم عمليات التكامل.
* [إنشاء رمز QR](/ar/api-reference/management-api/qr/create) — نقطة نهاية البيانات الأساسية التي تبدأ بها معظم عمليات التكامل.
* [نظرة عامة على MCP](/ar/mcp/overview) — تكامل مبني بالكامل على نفس هذه الـ API، باستخدام بيئة `mcp` مخصصة.