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

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

> كيف يتم تنظيم واجهات برمجة تطبيقات Plato، وأي قاعدة تستخدم URL، ومن أين تبدأ.

تتيح واجهات برمجة تطبيقات Plato للأدوات الموثوقة الاتصال بمساحة عمل Plato.

استخدمها عندما تحتاج إلى مزامنة بيانات القائمة، أو إرسال ردود على النماذج، أو قراءة إدخالات CMS أو كتابتها، أو توصيل تجربة الدردشة على موقع الويب، أو سحب بيانات طلبات المطاعم إلى نظام آخر.

## عائلات API

يجمع Plato نقاط نهاية REST الموثقة ضمن عائلات API أدناه.

<CardGroup cols={2}>
  <Card title="عناوين URL الأساسية" icon="globe" href="/ar/api-reference/base-url">
    اختر مضيف API الصحيح للإنتاج وإعداد وحدة التحكم والبيئات الخاصة والتطوير المحلي.
  </Card>

  <Card title="المصادقة" icon="key-round" href="/ar/api-reference/authentication">
    أرسل مفاتيح Plato API بأمان باستخدام العناوين واحتفظ بالمفاتيح بعيدًا عن التعليمات البرمجية العامة.
  </Card>

  <Card title="الأذونات" icon="settings" href="/ar/api-reference/permissions">
    قم بتعيين مفاتيح API للأدوار حتى يتمكن كل تكامل من الوصول إلى ما يحتاج إليه فقط.
  </Card>

  <Card title="الأخطاء والحدود" icon="life-buoy" href="/ar/api-reference/errors-and-limits">
    تعامل مع الأخطاء الشائعة وحدود ترقيم الصفحات وحدود المعدلات وعمليات إعادة المحاولة الآمنة.
  </Card>
</CardGroup>

## واجهات برمجة التطبيقات للبيانات وسير العمل

<CardGroup cols={2}>
  <Card title="CMS API" icon="database" href="/ar/api-reference/cms/overview">
    قراءة وكتابة إدخالات CMS المنظمة من مواقع الويب والتطبيقات والواجهات الخلفية الموثوقة.
  </Card>

  <Card title="Connect360 API" icon="message-circle" href="/ar/api-reference/connect360/overview">
    أنشئ دردشة على موقع الويب ومحادثة ومرفقات وتدفقات الرسائل بمساعدة AI.
  </Card>

  <Card title="واجهات برمجة تطبيقات المطاعم" icon="utensils" href="/ar/api-reference/restaurant/menu-products">
    اقرأ منتجات القائمة والفئات وبيانات موجز الطلبات الحديثة.
  </Card>

  <Card title="نماذج API" icon="clipboard-list" href="/ar/api-reference/forms/get-form">
    جلب مخططات النماذج العامة وإرسال استجابات النماذج الموثوقة.
  </Card>
</CardGroup>

## REST واجهات برمجة التطبيقات العامة

تكون واجهات برمجة تطبيقات REST العامة أفضل عندما يحتاج موقع ويب أو أداة بدون تعليمات برمجية أو واجهة خلفية غير TypeScript إلى نقاط نهاية HTTP عادية.

استخدمها من أجل:

* إدخالات CMS.
* منتجات القائمة والفئات.
* النماذج العامة.
* استلام طلبات المجمّعين.
* مرفقات Connect360 وردود AI.
* النماذج الديناميكية القديمة.

تمر طلبات REST عبر:

```text theme={null}
https://api.plato.ae
```

ابدأ بـ [المصادقة](/ar/api-reference/authentication)، ثم افتح عائلة API التي تحتاجها.

## ما ليس API العام

توجد بعض المسارات حتى يتمكن Plato من تشغيل وحدة التحكم أو معالجة خطافات الويب أو عرض ملفات PDF أو مصادقة المستخدمين. هذه الطرق ليست عقود تكامل عامة مستقرة.

لا تقم بإنشاء عمليات تكامل خارجية ضد مسارات مثل عمليات رد اتصال المصادقة أو خطافات الويب الخاصة بالموفر أو الشريط أو وظائف cron أو صور Open Graph أو طلبات متصفح وحدة التحكم الداخلية.

راجع [الطرق الداخلية](/ar/api-reference/internal-routes) للحصول على القائمة المختصرة للطرق التي يجب تجنبها.

## قبل أن تبني

1. إنشاء دور مخصص للتكامل.
2. امنح هذا الدور الأذونات التي يحتاجها فقط.
3. قم بإنشاء مفتاح API في وحدة التحكم.
4. قم بتخزين المفتاح في مخزن سري من جانب الخادم.
5. اختبر بطلب صغير قبل إرسال حركة الإنتاج.

إنشاء مفاتيح من [مفاتيح وحدة التحكم API](/ar/console/api-keys).