{"pageKey":"Developers","slug":"developers-api-integrations","locale":"ar","localeResolved":"ar","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/ar/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API المنتجات وعقود التكامل | MerchandAise","description":"استكشف عقود MerchandAise لأدوات المساعد، وعمليات دمج المجتمعات، وعمليات الموردين، وهويات المؤسسات، مع حدود وصول عامة ومحمية واضحة.","sections":[{"heading":"حافظ على مصدر موثوق واحد للبيانات","paragraphs":["يجب أن يوسع التكامل مسار عمل MerchandAise ولا يفرعه. يجب أن تقرأ وتحدث كل من واجهات الموقع، والتضمين، والموردين، والمؤسسات، والمساعد المستقبلي نفس التصميم وقصد التجارة والمُقايسة والموافقة وحالة الطلب ذات الإصدار.","Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order."]},{"heading":"API وواجهات التكامل","items":[{"title":"وثائق أدوات المساعد API","description":"استكشف نقاط نهاية المساعد والأدوات الحالية لجلسات التصميم ومراجعة التكامل. لا تمنح هذه المرجعية العامة صلاحية مجهولة لإصدار مُقايسة أو تقديم طلب. Human guide: فتح وثائق أدوات المساعد (/ar/developers/api-integrations). Machine-readable contract: أدوات المساعد OpenAPI JSON (/api/docs/openapi.json). الوصول: عام. مرجع عام لأدوات المساعد وAPIs الخاصة بها. لا يزال الوصول للإنتاج والعمليات المؤثرة على الطلبات تتطلب التفويض المعمول به. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"تضمين المجتمع API","description":"اربط تجارب الأندية أو المجتمعات أو المتاجر المحلية بعمليات تسليم التصميم والتجارة المملوكة لـ MerchandAise دون إعادة بناء مسار العمل الأساسي. Human guide: مراجعة دليل تكامل المجتمع (/ar/developers/api-integrations#community-integrations). Machine-readable contract: المجتمع OpenAPI JSON (/api/v1/community/public/openapi/v1). الوصول: عام. عقد عام ذو إصدارات لتضمينات المتاجر، واكتشاف المجتمعات، وعمليات التسليم المدركة للغة المحلية. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"المورد API","description":"قم بربط الموردين المعتمدين بعمليات الإعداد والكتالوج والمُقايسة والتنفيذ بعد تأهيل علاقة المورد ونموذج الوصول. Human guide: مراجعة دليل تكامل الموردين (/ar/developers/api-integrations#supplier-integrations). Machine-readable contract: المورد OpenAPI JSON (/api/v1/supplier/openapi/v1). الوصول: عام. عقد عام للتخطيط وتوليد العميل. يظل الوصول التشغيلي للموردين خاضعاً للأذونات. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"هوية المؤسسة API","description":"خطط لـ SSO وتوفير SCIM وتدفقات الهوية الجاهزة للمراجعة لبرامج بضائع الشركات المعتمدة عمليات الإطلاق المنظمة. Human guide: مراجعة دليل تكامل المؤسسات (/ar/developers/api-integrations#enterprise-integrations). Machine-readable contract: هوية المؤسسة OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). الوصول: محمي. عقد محمي لمساحات العمل المؤسسية المعتمدة؛ اطلب الوصول قبل استخدام نقطة النهاية هذه. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"اختر العقد قبل كتابة الكود","items":[{"title":"Step 1: حدد رحلة المستخدم","description":"قرر من يدخل مسار العمل وأين: مشتري في متجر ضمني، أو مورد معتمد، أو مستخدم مؤسسي، أو مساعد يعمل بتفويض صريح."},{"title":"Step 2: تأكد من حدود الوصول","description":"استخدم العقود العامة للتقييم وتوليد العملاء، ثم تحقق من بيانات الاعتماد، والنطاقات، والبيئات، ونداءات الاستدعاء (callbacks)، ونقاط النهاية المحمية قبل التنفيذ."},{"title":"Step 3: أثبت استمرارية الحالة","description":"اختبر أن التصاميم، والمُقايسات، والموافقات، والأخطاء، وعمليات تسليم الطلبات تحافظ على توافق إصداراتها عبر التكامل، بما في ذلك محاولات إعادة المحاولة مسارات التراجع."}]},{"heading":"ما يجب أن تحافظ عليه كل عملية تكامل","items":[{"title":"حالة واحدة ذات إصدار","description":"تبقى التصاميم، وقصد التجارة، والمُقايسة المدعومة من المورد، والموافقة، وحالة الطلب متصلة. يجب أن تؤدي التغييرات القديمة إلى طلب مُقايسة جديد مرئي أو حالة مراجعة."},{"title":"خصوصية التجارة والموردين","description":"MerchandAise يظل هو التاجر ومالك الدعم الذي يتعامل معه المشتري مباشرة. لا يتم الكشف عن هويات الموردين وجهات الاتصال والبيانات الداخلية من خلال عمليات التكامل العامة."},{"title":"الموافقة قبل الإنتاج","description":"A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding."}]},{"heading":"قبل إطلاق حركة مرور الإنتاج","paragraphs":["ملف OpenAPI المنشور هو سطح تخطيط، وليس وعداً بالوصول المجهول للإنتاج. نحن نراجع البيئات، وبيانات الاعتماد، ومعالجة الأخطاء، والملكية التشغيلية قبل الإطلاق الفعلي."],"items":[{"title":"الوصول والبيئات","description":"تأكد من إصدار العقد، ومساحة العمل المعتمدة، ونطاقات المصادقة، والبيئة التجريبية (sandbox)، وبيانات اعتماد الإنتاج، ووجهات نداء الاستدعاء (callbacks)."},{"title":"الفشل والاستعادة","description":"حدد محاولات إعادة المحاولة، وعدم التأثر بتكرار العمليات (idempotency)، ومهل الانتظار، والأخطاء المرئية للعملاء، والمراقبة، وملكية الدعم، والتراجع قبل الإصدار."},{"title":"أدلة شاملة من البداية للنهاية","description":"تحقق من الرحلة المستهدفة في بيئة الاختبار (staging) بدءاً من الإدخال وتغيير الحالة مروراً بالمُقايسة، والموافقة، والتسليم، وسلوك الاستعادة."}]},{"heading":"الأسئلة الشائعة","items":[{"title":"بأي واجهة تكامل يجب أن أبدأ؟","description":"ابدأ بالشخص وانتقال الحالة. استخدم عمليات التضمين المجتمعية لرحلات الأندية أو المجتمعات الموجهة للمشتري، أو عمليات الموردين لمسار العمل المعتمد من جانب التوريد، أو هوية المؤسسة لـ SSO وSCIM، وأدوات المساعد فقط للتدفقات الموجهة من AI والمعتمدة صراحة."},{"title":"هل يعني العقد العام إمكانية الوصول العام للإنتاج؟","description":"لا. يدعم عقد OpenAPI العام الاكتشاف ومراجعة البنية وتوليد العملاء. قد لا تزال بيانات اعتماد الإنتاج، وعمليات الكتابة، ومسارات عمل الموردين، وهويات المؤسسات، وتنفيذ المساعد تتطلب مساحة عمل معتمدة وتفويضاً محدد النطاق."},{"title":"هل يمكن للتكامل الكشف عن الموردين أو تجاوز الموافقات؟","description":"No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements."}]},{"heading":"احضر لنا مسار العمل، وليس بنية برمجية جاهزة.","paragraphs":["أخبرنا بمن سيستخدم التكامل، والحالة التي يحتاجون إلى قراءتها أو تغييرها، والمكان الذي ستعيش فيه التجربة. سنقوم بتخطيط العقد، وننموذج الوصول، وأكثر مسارات الطرح أماناً معك."],"items":[{"title":"تخطيط التكامل","description":"/ar/contact?intent=api-integration-review"},{"title":"استكشف وكلاء AI وMCP","description":"/ar/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}