# API المنتجات وعقود التكامل | MerchandAise

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

استكشف عقود MerchandAise لأدوات المساعد، وعمليات دمج المجتمعات، وعمليات الموردين، وهويات المؤسسات، مع حدود وصول عامة ومحمية واضحة.

## حافظ على مصدر موثوق واحد للبيانات
يجب أن يوسع التكامل مسار عمل MerchandAise ولا يفرعه. يجب أن تقرأ وتحدث كل من واجهات الموقع، والتضمين، والموردين، والمؤسسات، والمساعد المستقبلي نفس التصميم وقصد التجارة والمُقايسة والموافقة وحالة الطلب ذات الإصدار.
حيثما تعالج MerchandAise معاملة المشتري، فإن Hutter Products GmbH هو البائع المتعاقد وتاجر السجل تحت العلامة التجارية MerchandAise. تظل هوية المورد وتفاصيل الاتصال الخاصة به سرية إلا في الحالات التي تتطلب الإفصاح، ولا يزال الإنتاج يتطلب الموافقة على الدليل الرقمي والعينة الأصلية.

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

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

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

## قبل إطلاق حركة مرور الإنتاج
ملف OpenAPI المنشور هو سطح تخطيط، وليس وعداً بالوصول المجهول للإنتاج. نحن نراجع البيئات، وبيانات الاعتماد، ومعالجة الأخطاء، والملكية التشغيلية قبل الإطلاق الفعلي.
- **الوصول والبيئات:** تأكد من إصدار العقد، ومساحة العمل المعتمدة، ونطاقات المصادقة، والبيئة التجريبية (sandbox)، وبيانات اعتماد الإنتاج، ووجهات نداء الاستدعاء (callbacks).
- **الفشل والاستعادة:** حدد محاولات إعادة المحاولة، وعدم التأثر بتكرار العمليات (idempotency)، ومهل الانتظار، والأخطاء المرئية للعملاء، والمراقبة، وملكية الدعم، والتراجع قبل الإصدار.
- **أدلة شاملة من البداية للنهاية:** تحقق من الرحلة المستهدفة في بيئة الاختبار (staging) بدءاً من الإدخال وتغيير الحالة مروراً بالمُقايسة، والموافقة، والتسليم، وسلوك الاستعادة.

## الأسئلة الشائعة
- **بأي واجهة تكامل يجب أن أبدأ؟:** ابدأ بالشخص وانتقال الحالة. استخدم عمليات التضمين المجتمعية لرحلات الأندية أو المجتمعات الموجهة للمشتري، أو عمليات الموردين لمسار العمل المعتمد من جانب التوريد، أو هوية المؤسسة لـ SSO وSCIM، وأدوات المساعد فقط للتدفقات الموجهة من AI والمعتمدة صراحة.
- **هل يعني العقد العام إمكانية الوصول العام للإنتاج؟:** لا. يدعم عقد OpenAPI العام الاكتشاف ومراجعة البنية وتوليد العملاء. قد لا تزال بيانات اعتماد الإنتاج، وعمليات الكتابة، ومسارات عمل الموردين، وهويات المؤسسات، وتنفيذ المساعد تتطلب مساحة عمل معتمدة وتفويضاً محدد النطاق.
- **هل يمكن للتكامل الكشف عن الموردين أو تجاوز الموافقات؟:** لا. تظل هوية المورد وتفاصيل الاتصال الخاصة به سرية إلا في الحالات التي تتطلب الإفصاح، وتمتلك MerchandAise علاقة المشتري، ويجب أن تحافظ الإجراءات المؤثرة على الطلبات على بوابات الموافقة وعينة الإنتاج الأصلية المكونة.

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