انتقل إلى المحتوى الرئيسي

MerchandAise منصة المطورين

قم بتوصيل سير العمل الخاص بك إلى MerchandAise.

ابحث عن وثائق واجهة برمجة التطبيقات (API) ومواصفات OpenAPI لسير عمل البضائع المخصصة. قم بتوصيل مواقع الويب أو المجتمعات أو عمليات الموردين أو حسابات الشركة بمعلومات التصميم والاقتباس والطلب المشتركة.

اختر الاتصال الذي يحتاجه مشروعك

استخدم المراجع أدناه لتقييم نقاط النهاية وتنسيقات الطلب ومتطلبات الترخيص. المواصفات العامة تدعم التخطيط وتوليد العملاء؛ يعتمد الوصول التشغيلي على واجهة برمجة التطبيقات والحساب والبيئة.

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

01 — العقود

واجهة برمجة التطبيقات (API) وأسطح التكامل

01

مستندات API وOpenAPI

ابحث عن مرجع واجهة برمجة التطبيقات (API) للأدوات المساعدة وجلسات التصميم، ثم اختر عقد المجتمع أو المورد أو المؤسسة لسير عملك.

الوصول: عام/api/docs/openapi.json

مرجع عام لواجهات برمجة التطبيقات للمساعد والأدوات. ولا تزال عمليات الوصول إلى الإنتاج والعمليات المؤثرة على الطلب تتطلب الحصول على إذن ساري المفعول.

02

واجهة برمجة تطبيقات المجتمع

قم بتوصيل موقع الويب الخاص بالنادي أو المجتمع بمعلومات المجتمع العامة وعمليات إرسال التصميم والتصويت وعمليات الموافقة على الطلب.

ما يغطيه العقد
سياق المجتمع العام، ومنشورات التصميم والتصويتات، ونشر القائمة، والأوامر المعلقة، وموافقة مالك المجتمع أو رفضه.
نقطة انطلاق عملية
قراءة سياق المجتمع العام لموقع النادي. ثم حدد الإجراءات التي تتطلب جلسة عضو أو أذونات المالك قبل إضافة عمليات إرسال التصميم أو عمليات تسليم الدفع.
الوصول
المواصفات عامة. القراءات العامة وإجراءات الأعضاء والعمليات الخاصة بالمالك فقط لها متطلبات ترخيص مختلفة؛ استخدم قواعد الأمان في كل نقطة نهاية.
الوصول: عام

عقد الآلة

مجتمع OpenAPI JSON
/api/v1/community/public/openapi/v1

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

03

واجهة برمجة تطبيقات المورد

قم بتوصيل أنظمة الموردين المعتمدة بحزم الإنتاج التي تم إصدارها وحالة الإعداد وسير عمل خطاف الويب ERP أو PLM.

ما يغطيه العقد
حالة تأهيل الموردين، وحزم الإنتاج التي تم إصدارها، وتنزيلات العناصر المدققة، والتحليلات، واشتراكات خطاف الويب، ونقاط تفتيش المزامنة.
نقطة انطلاق عملية
خطط للاتصال بين نظام تخطيط موارد المؤسسات (ERP) أو نظام إدارة دورة حياة المنتج ومركز الموردين. قم بمراجعة حمولات خطاف الويب وإعادة المحاولة وحالة المزامنة قبل التعامل مع الطلب المعين.
الوصول
اقرأ مواصفات OpenAPI دون تسجيل الدخول. تتطلب طلبات التشغيل حساب المورد المناسب والأذونات؛ لا تقوم الوثائق العامة بتسجيل مورد أو منح حق الوصول إلى بيانات مورد آخر.
الوصول: عام

عقد الآلة

المورد OpenAPI JSON
/api/v1/supplier/openapi/v1

العقد العام للتخطيط وتوليد العملاء. يظل الوصول التشغيلي للموردين مسموحًا به.

04

واجهة برمجة تطبيقات هوية المؤسسة

قم بتوصيل مساحات عمل الشركة المعتمدة بتسجيل الدخول الموحد وتوفير المستخدمين والمجموعات وسجلات تدقيق الهوية.

ما يغطيه العقد
تسجيل الدخول الموحد لـ OpenID Connect (OIDC)، وعمليات دورة حياة مستخدم والمجموعة لـ SCIM، وتدوير رمز SCIM المميز، وأحداث تدقيق التوفير.
نقطة انطلاق عملية
قم بتعيين موفر الهوية الخاص بك إلى مساحة العمل المعتمدة. قم بتخطيط تسجيل الدخول وتوفير المستخدم وإلغاء التوفير، ثم التحقق من تعيينات المجموعة وسجلات التدقيق في بيئة الاختبار المتفق عليها.
الوصول
مواصفات هوية المؤسسة محمية. اتصل بفريق عمليات التكامل لمراجعة مساحة العمل ومتطلبات الوصول قبل التنفيذ. تعد هوية المؤسسة اختيارية لعمليات شراء المنتجات العادية.
الوصول: محمي

عقد الآلة

هوية المؤسسة OpenAPI JSON
/api/v1/enterprise/identity/openapi/v1

العقد المحمي لمساحات العمل المعتمدة في المؤسسة؛ طلب الوصول قبل استخدام نقطة النهاية هذه.

التخطيط للتكامل

02 — دليل التنفيذ

اختر العقد قبل الكود

  1. 01

    رسم خريطة لرحلة المستخدم

    حدد من يدخل سير العمل وأين: مشتري في واجهة متجر مضمنة، أو مورد معتمد، أو مستخدم مؤسسة، أو مساعد يعمل بتفويض صريح.

  2. 02

    تأكيد حدود الوصول

    استخدم العقود العامة للتقييم وإنشاء العملاء، ثم قم بتأكيد بيانات الاعتماد والنطاقات والبيئات وعمليات الاسترجاعات ونقاط النهاية المحمية قبل التنفيذ.

  3. 03

    إثبات استمرارية الدولة

    اختبار بقاء التصميمات وعروض الأسعار والموافقات والأخطاء وعمليات تسليم الطلبات محدثة عبر التكامل، بما في ذلك عمليات إعادة المحاولة ومسارات التراجع.

03 — ما يجب أن يحافظ عليه كل تكامل

ما يجب أن يحافظ عليه كل تكامل

حالة إصدار واحد

يظل التصميم والنية التجارية والاقتباس المدعوم من المورد والموافقة وحالة الطلب على اتصال. يجب أن تؤدي التغييرات القديمة إلى ظهور حالة إعادة تسعير أو مراجعة مرئية.

الخصوصية التجارية والموردين

يظل MerchandAise هو التاجر الذي يواجه المشتري ومالك الدعم. لا يتم الكشف عن هويات الموردين وجهات الاتصال والبيانات الداخلية من خلال عمليات التكامل العامة.

الموافقة قبل الإنتاج

العرض ثلاثي الأبعاد ليس دليلاً ماديًا. يشرح عرض الأسعار المؤكد أي خيارات متاحة لعينة العملاء والتكاليف والقيود والتوقيت. الموافقة على نموذج المعاينة الرقمي الدقيق وإكمال الفحوصات الفنية الإلزامية وأي موافقة على العينة المطلوبة أو المحددة قبل الإنتاج الضخم. تظل متطلبات الطلب المقبولة الحالية ملزمة.

04

قبل حركة الإنتاج

يعد ملف OpenAPI المنشور بمثابة سطح تخطيط، وليس وعدًا بالوصول المجهول إلى الإنتاج. نقوم بمراجعة البيئات وبيانات الاعتماد ومعالجة الفشل والملكية التشغيلية قبل بدء التشغيل.

01

الوصول والبيئات

قم بتأكيد إصدار العقد ومساحة العمل المعتمدة ونطاقات المصادقة ووضع الحماية وبيانات اعتماد الإنتاج ووجهات رد الاتصال.

02

الفشل والتعافي

حدد عمليات إعادة المحاولة، والعجز، والمهلات، والأخطاء المرئية للعميل، وقابلية الملاحظة، وملكية الدعم، والتراجع قبل الإصدار.

03

الأدلة نهاية إلى نهاية

تحقق من الرحلة المقصودة في التدريج من الدخول وطفرة الحالة من خلال سلوك الاقتباس والموافقة والتسليم والاسترداد.

الأسئلة الشائعة

ما هي واجهة برمجة التطبيقات الخاصة بالبضائع التي يجب أن أبدأ بها؟

ابدأ بانتقال الشخص والدولة. استخدم تضمينات المجتمع لرحلات النادي أو المجتمع التي تواجه المشتري، وعمليات الموردين لعمليات سير العمل المعتمدة من جانب العرض، وهوية المؤسسة لتسجيل الدخول الموحد (SSO) وSCIM، والأدوات المساعدة فقط للتدفقات المعتمدة بشكل صريح والتي يقودها الذكاء الاصطناعي.

هل العقد العام يعني الوصول إلى الإنتاج العام؟

لا. يدعم عقد OpenAPI العام الاكتشاف ومراجعة البنية وإنشاء العملاء. لا تزال بيانات اعتماد الإنتاج، وعمليات الكتابة، وسير عمل الموردين، وهوية المؤسسة، والتنفيذ المساعد تتطلب مساحة عمل معتمدة وتفويضًا محددًا.

هل يمكن للتكامل كشف الموردين أو تجاوز الموافقات؟

لا. تظل هوية المورد وتفاصيل الاتصال خاصة به باستثناء الحالات التي يكون فيها الإفصاح مطلوبًا، ويمتلك MerchandAise علاقة المشتري، ويجب أن تحافظ الإجراءات التي تؤثر على الطلب على متطلبات الموافقة على العينة المحددة للإثبات الرقمي والفني والمحددة للطلب.

خطط لتكاملك معنا.

أخبرنا بمن سيستخدم التكامل، والحالة التي يحتاج إلى قراءتها أو تغييرها، وأين ستعيش التجربة. سنرسم معك العقد ونموذج الوصول ومسار التنفيذ الأكثر أمانًا.