# 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: Assistant tooling 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/developers/api-integrations#community-integrations). 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/developers/api-integrations#supplier-integrations). 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/developers/api-integrations#enterprise-integrations). 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.

## Production launch gates for developers
A production integration needs more than a public endpoint. Use these gates to decide whether your workflow is ready for customer, supplier, enterprise, or AI-agent traffic.
- **Sandbox and access review:** Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch.
- **Versioned implementation evidence:** Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled.
- **Operational observability:** Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user.

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