# API مستندات + تضمين المجتمع API | MerchandAise

- slug: developers-api-integrations
- locale: ar
- localeResolved: ar
- canonical: https://www.merchandaise.com/ar/developers/api-integrations

قم بمراجعة المستندات التي يمكن قراءتها بواسطة الإنسان وعقود OpenAPI القابلة للقراءة آليًا للتخطيط والاختبار وإدارة الإصدارات. قم بتنفيذ عمليات تضمين واجهة المتجر الآمنة محليًا، وسير عمل المجتمع، وعمليات التسليم المصادق عليها باستخدام عقد عام مُصدر. استخدم واجهات برمجة التطبيقات MerchandAise وعقود OpenAPI وعمليات التضمين المجتمعية وسير عمل الموردين وهوية المؤسسة وأدوات MCP لتوصيل البضائع المخصصة بمواقع الويب والبوابات ووكلاء AI.

## أسطح التكامل والعقود
استخدم واجهات برمجة التطبيقات MerchandAise وعقود OpenAPI وعمليات التضمين المجتمعية وسير عمل الموردين وهوية المؤسسة وأدوات MCP لتوصيل البضائع المخصصة بمواقع الويب والبوابات ووكلاء AI.
قم بمراجعة المستندات التي يمكن قراءتها بواسطة الإنسان وعقود OpenAPI القابلة للقراءة آليًا للتخطيط والاختبار وإدارة الإصدارات.
قم بتنفيذ عمليات تضمين واجهة المتجر الآمنة محليًا، وسير عمل المجتمع، وعمليات التسليم المصادق عليها باستخدام عقد عام مُصدر.

## أسطح التكامل والعقود
- **API مستندات:** قم بمراجعة المستندات التي يمكن قراءتها بواسطة الإنسان وعقود OpenAPI القابلة للقراءة آليًا للتخطيط والاختبار وإدارة الإصدارات. Human guide: API مستندات (/api/docs). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **تضمين المجتمع API:** قم بتنفيذ عمليات تضمين واجهة المتجر الآمنة محليًا، وسير عمل المجتمع، وعمليات التسليم المصادق عليها باستخدام عقد عام مُصدر. Human guide: تضمين المجتمع API (/ar/community). Machine-readable contract: عقد مجتمعي مفتوح (/api/v1/community/public/openapi/v1). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **المورد API:** قم بتوصيل عمليات الإعداد والكتالوج والعمليات من جانب المورد من خلال نقاط النهاية ذات الإصدارات المصممة لسير عمل التنفيذ. Human guide: المورد API (/ar/partners). Machine-readable contract: فتح عقد المورد (/api/v1/supplier/openapi/v1). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **هوية المؤسسة API:** قم بدمج توفير SSO وSCIM وتدفقات الهوية الجاهزة للتدقيق لعمليات طرح المؤسسة وإدارتها من خلال عقد محمي للوصول المعتمد للمؤسسة. Human guide: هوية المؤسسة API (/ar/enterprise). Machine-readable contract: فتح عقد هوية المؤسسة (/api/v1/enterprise/identity/openapi/v1). Access: protected. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## التكامل السريع
- **Step 1: اختر العقد الذي يتوافق مع سير عملك:** ابدأ بالسطح الذي يتطابق مع نموذج المستخدم والمصادقة الخاص بك: تضمين المجتمع، أو هوية المؤسسة، أو عمليات الموردين، أو أدوات MCP للمساعدين.
- **Step 2: التحقق من صحة المصادقة والإصدار وحدود البيئة:** قم بتأكيد الرؤوس والنطاقات وتوقعات رد الاتصال وإصدارات العقد المطلوبة في التدريج قبل توجيه حركة مرور الإنتاج.
- **Step 3: اختبار سير العمل الشامل قبل الإطلاق:** تحقق من الطلبات وخطافات الويب والتوفير وإمكانية المراقبة ومسارات التراجع حتى يكون التكامل موثوقًا به من الاستخدام المباشر الأول.

## من يبني مع MerchandAise
- **مشغلي المجتمع:** قم بتشغيل واجهات المتاجر المضمنة وعمليات تسليم المكوّنات وتدفقات المجتمع داخل مواقع النادي والدوري والشركة من خلال العقود العامة ذات الإصدارات.
- **فرق المؤسسة وشركاء النظام الأساسي:** قم بتوصيل بوابات المشتريات وأنظمة الهوية والعمليات الداخلية بسير عمل البضائع دون إعادة بناء منطق الموافقة والمورد.
- **AI وكيل وبناة الأتمتة:** امنح المساعدين إمكانية الوصول إلى الأدوات المنظمة للاكتشاف والاقتباس والعمليات المعتمدة من خلال نقاط النهاية المتوافقة مع MCP.

## هل تحتاج إلى مراجعة التكامل؟
شارك تصميمك والمخطط الزمني للطرح والقنوات الوجهة. سنوصي بسطح العقد المناسب ونمط المصادقة وتسلسل الإطلاق.
- **تحدث إلى فريق التكامل:** /ar/contact
- **View AI Agents and MCP:** /ar/developers/ai-agents-mcp