{"pageKey":"Developers","slug":"developers","locale":"ar","localeResolved":"ar","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/ar/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"المطور API، أدوات التضمين، أدوات MCP وتكامل المؤسسات | MerchandAise","description":"استكشف واجهات برمجة تطبيقات مطوري MerchandAise للبضائع المخصصة: مستندات OpenAPI، وتضمينات المجتمع، وسير عمل الموردين، وهوية المؤسسة، وأدوات MCP لوكلاء AI.","sections":[{"heading":"منصة المطور","paragraphs":["استخدم واجهات برمجة التطبيقات MerchandAise وعقود OpenAPI وعمليات التضمين المجتمعية وسير عمل الموردين وهوية المؤسسة وأدوات MCP لتوصيل البضائع المخصصة بمواقع الويب والبوابات ووكلاء AI."]},{"heading":"من يبني مع MerchandAise","items":[{"title":"مشغلي المجتمع","description":"قم بتشغيل واجهات المتاجر المضمنة وعمليات تسليم المكوّنات وتدفقات المجتمع داخل مواقع النادي والدوري والشركة من خلال العقود العامة ذات الإصدارات."},{"title":"فرق المؤسسة وشركاء النظام الأساسي","description":"قم بتوصيل بوابات المشتريات وأنظمة الهوية والعمليات الداخلية بسير عمل البضائع دون إعادة بناء منطق الموافقة والمورد."},{"title":"AI وكيل وبناة الأتمتة","description":"امنح المساعدين إمكانية الوصول إلى الأدوات المنظمة للاكتشاف والاقتباس والعمليات المعتمدة من خلال نقاط النهاية المتوافقة مع MCP."}]},{"heading":"أسطح التكامل والعقود","items":[{"title":"API مستندات","description":"قم بمراجعة المستندات التي يمكن قراءتها بواسطة الإنسان وعقود OpenAPI القابلة للقراءة آليًا للتخطيط والاختبار وإدارة الإصدارات. Human guide: Read API docs (/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: /developers#api-docs."},{"title":"تضمين المجتمع API","description":"قم بتنفيذ عمليات تضمين واجهة المتجر الآمنة محليًا، وسير عمل المجتمع، وعمليات التسليم المصادق عليها باستخدام عقد عام مُصدر. 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. Public versioned contract for storefront embeds, community discovery, and locale-aware handoffs. Canonical section: /developers#community-integrations."},{"title":"المورد API","description":"قم بتوصيل عمليات الإعداد والكتالوج والعمليات من جانب المورد من خلال نقاط النهاية ذات الإصدارات المصممة لسير عمل التنفيذ. Human guide: Explore partner workflow (/ar/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Public contract for planning and client generation. Operational supplier access remains permissioned. Canonical section: /developers#supplier-integrations."},{"title":"هوية المؤسسة API","description":"قم بدمج توفير 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. Protected contract for approved enterprise workspaces; request access before using this endpoint. Canonical section: /developers#enterprise-integrations."},{"title":"أدوات MCP","description":"كشف إمكانات MerchandAise المعتمدة لوكلاء AI من خلال تعريفات الأدوات المتوافقة مع MCP القابلة للاكتشاف ونقاط نهاية التنفيذ مع ترخيص المساعد. Human guide: Read MCP implementation guide (/ar/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/ar/.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: /developers#mcp-tools."}]},{"heading":"التكامل السريع","items":[{"title":"Step 1: اختر العقد الذي يتوافق مع سير عملك","description":"ابدأ بالسطح الذي يتطابق مع نموذج المستخدم والمصادقة الخاص بك: تضمين المجتمع، أو هوية المؤسسة، أو عمليات الموردين، أو أدوات MCP للمساعدين."},{"title":"Step 2: التحقق من صحة المصادقة والإصدار وحدود البيئة","description":"قم بتأكيد الرؤوس والنطاقات وتوقعات رد الاتصال وإصدارات العقد المطلوبة في التدريج قبل توجيه حركة مرور الإنتاج."},{"title":"Step 3: اختبار سير العمل الشامل قبل الإطلاق","description":"تحقق من الطلبات وخطافات الويب والتوفير وإمكانية المراقبة ومسارات التراجع حتى يكون التكامل موثوقًا به من الاستخدام المباشر الأول."}]},{"heading":"What production-ready means","paragraphs":["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."],"items":[{"title":"Sandbox and access review","description":"Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch."},{"title":"Versioned implementation evidence","description":"Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled."},{"title":"Operational observability","description":"Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user."}]},{"heading":"هل تحتاج إلى مراجعة التكامل؟","paragraphs":["شارك تصميمك والمخطط الزمني للطرح والقنوات الوجهة. سنوصي بسطح العقد المناسب ونمط المصادقة وتسلسل الإطلاق."],"items":[{"title":"تحدث إلى فريق التكامل","description":"/ar/contact/integrations"},{"title":"اكتشف منصة المؤسسة","description":"/ar/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}