# المطور API، أدوات التضمين، أدوات MCP وتكامل المؤسسات | MerchandAise

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

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

## منصة المطور
استخدم واجهات برمجة التطبيقات MerchandAise وعقود OpenAPI وعمليات التضمين المجتمعية وسير عمل الموردين وهوية المؤسسة وأدوات MCP لتوصيل البضائع المخصصة بمواقع الويب والبوابات ووكلاء AI.

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

## أسطح التكامل والعقود
- **API مستندات:** قم بمراجعة المستندات التي يمكن قراءتها بواسطة الإنسان وعقود OpenAPI القابلة للقراءة آليًا للتخطيط والاختبار وإدارة الإصدارات. Human guide: قراءة مستندات API (/ar/developers/api-integrations). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /ar/developers#api-docs.
- **تضمين المجتمع API:** قم بتنفيذ عمليات تضمين واجهة المتجر الآمنة محليًا، وسير عمل المجتمع، وعمليات التسليم المصادق عليها باستخدام عقد عام مُصدر. Human guide: Explore community workflows (/ar/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. عقد ذو إصدار عام لتضمين واجهة المتجر، واكتشاف المجتمع، وعمليات التسليم المدركة للإعدادات المحلية. Canonical section: /ar/developers#community-integrations.
- **المورد API:** قم بتوصيل عمليات الإعداد والكتالوج والعمليات من جانب المورد من خلال نقاط النهاية ذات الإصدارات المصممة لسير عمل التنفيذ. Human guide: Explore partner workflow (/ar/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. العقد العام للتخطيط وتوليد العملاء. يظل الوصول التشغيلي للموردين مسموحًا به. Canonical section: /ar/developers#supplier-integrations.
- **هوية المؤسسة API:** قم بدمج توفير SSO وSCIM وتدفقات الهوية الجاهزة للتدقيق لعمليات طرح المؤسسة وإدارتها من خلال عقد محمي للوصول المعتمد للمؤسسة. Human guide: Explore enterprise platform (/ar/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. العقد المحمي لمساحات العمل المعتمدة في المؤسسة؛ طلب الوصول قبل استخدام نقطة النهاية هذه. Canonical section: /ar/developers#enterprise-integrations.
- **أدوات MCP:** كشف إمكانات MerchandAise المعتمدة لوكلاء AI من خلال تعريفات الأدوات المتوافقة مع MCP القابلة للاكتشاف ونقاط نهاية التنفيذ مع ترخيص المساعد. Human guide: اقرأ دليل تنفيذ MCP (/ar/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /ar/developers#mcp-tools.

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

## What production-ready means
يحتاج تكامل الإنتاج إلى أكثر من مجرد نقطة نهاية عامة. استخدم هذه البوابات لتحديد ما إذا كان سير عملك جاهزًا لحركة مرور العملاء أو الموردين أو المؤسسات أو وكلاء الذكاء الاصطناعي.
- **Sandbox and access review:** تأكد من العقود العامة، وما هي أسطح المؤسسات التي تتطلب الموافقة عليها، وما هي بيانات الاعتماد أو أدوار مساحة العمل المطلوبة قبل الإطلاق.
- **Versioned implementation evidence:** احتفظ بالعملاء الذين تم إنشاؤهم وعناوين URL لرد الاتصال ونطاقات المصادقة وإصدارات العقود وملكية التراجع موثقة قبل تمكين حركة الإنتاج.
- **Operational observability:** سجلات الخطة، وإعادة المحاولة، وملكية الدعم، وحالات الفشل، وعمليات التحقق من السلامة لكل سير عمل يمكن أن يؤثر على الطلب أو المورد أو مستخدم المؤسسة.

## هل تحتاج إلى مراجعة التكامل؟
شارك تصميمك والمخطط الزمني للطرح والقنوات الوجهة. سنوصي بسطح العقد المناسب ونمط المصادقة وتسلسل الإطلاق.
- **تحدث إلى فريق التكامل:** /ar/contact/integrations
- **اكتشف منصة المؤسسة:** /ar/enterprise