{ "version": "https://jsonfeed.org/version/1", "title": "Madabina Blog", "home_page_url": "https://blog.madabina.com/ar/articles", "description": "Ideas for sellers and developers building commerce with Madabina.", "items": [ { "id": "https://blog.madabina.com/ar/articles/developers/mcp-client", "content_html": "

يوفر خادم Madabina MCP لعملاء متوافقين إمكانية التفاعل مع بيانات المتجر التي أذن بها التاجر. يستخدم الاتصال Streamable HTTP وOAuth، لذلك يجب أن يدعم العميل مسار التفويض واكتشاف بيانات المورد المحمي.

\n

استخدم نقطة الاتصال ومسار OAuth الموثقين​

\n

نقطة MCP هي https://mcp.madabina.com/mcp. تُنشر بيانات المورد المحمي في https://mcp.madabina.com/.well-known/oauth-protected-resource، وخادم التفويض هو https://madabina.com.

\n

أعد إعداد عميل يدعم Streamable HTTP واكتشاف OAuth. يكمل التاجر التفويض عبر مسار العميل. لا تلصق رمز التاجر في إعداد مشترك ولا تعتبر عنوان الخادم وحده تفويضاً.

\n

اطلب الصلاحيات الضرورية فقط​

\n

تفصل النطاقات الموثقة بين القراءة وكتابة المنتجات وكتابة الطلبات والعمليات المدمرة. اطلب فقط ما تحتاج إليه الميزة. يتطلب حذف منتج أو إلغاء طلب نطاق الصلاحيات المدمرة؛ لذلك لا ينبغي لتكامل القراءة فقط طلبه.

\n

يرتبط الوصول بحساب التاجر المصرح به والمتجر المحدد. أظهر سياق المتجر في التكامل ولا تفترض أن لكل تاجر متجراً واحداً فقط.

\n

تعامل بحذر مع عمليات الكتابة​

\n

تتطلب عمليات الكتابة في MCP مفتاح idempotency بصيغة UUID. إذا انتهت مهلة عملية تعديل، فلا تعاودها تلقائياً بمفتاح جديد؛ اتبع الإرشادات الحالية للخادم وأعد استخدام المفتاح نفسه عند إعادة المحاولة للعملية ذاتها.

\n

لا تضع الرموز في السجلات أو الشيفرة المصدرية. إذا فشل التفويض، راجع اكتشاف OAuth في العميل والوثائق الرسمية بدلاً من إدخال بيانات الاعتماد يدوياً.

\n

راجع قائمة الأدوات والصلاحيات الحالية​

\n

قد تتغير الأدوات والصلاحيات المتاحة. قبل إطلاق التكامل، راجع دليل خادم Madabina MCP للاطلاع على بيانات الاتصال ونطاقات الصلاحيات وسلوك التعديلات الحالي.

", "url": "https://blog.madabina.com/ar/articles/developers/mcp-client", "title": "ربط عميل MCP بـ Madabina: OAuth ونطاقات الصلاحيات", "summary": "تعرّف على تفاصيل الاتصال الموثقة ومتطلبات OAuth ونموذج الصلاحيات لخادم Madabina MCP.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "فريق تحرير Madabina", "url": "https://madabina.com" }, "tags": [ "للمطورين" ] }, { "id": "https://blog.madabina.com/ar/articles/sellers/product-page-checklist", "content_html": "

ينبغي أن تساعد صفحة المنتج العميل على فهم ما يُعرض قبل تقديم الطلب. كما تسهّل المعلومات الواضحة إدارة المتجر، إذ يمكن للتاجر مراجعة التفاصيل المهمة نفسها عند كل تحديث.

\n

استخدم هذه القائمة عند إضافة منتج أو تعديله في متجر Madabina.

\n

اختر اسماً محدداً للمنتج​

\n

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

\n

أضف صوراً تُظهر المنتج​

\n

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

\n

اشرح التفاصيل المهمة​

\n

اكتب وصفاً بسيطاً، وأضف المادة والأبعاد والتوافق وتعليمات العناية أو غيرها من الحقائق التي تهم هذا المنتج. ميّز المعلومات المؤكدة عن التقديرات والتوصيات، واحذف التفاصيل التي لم تعد صحيحة.

\n

راجع السعر والتوفر​

\n

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

\n

راجع اللغات والتصنيف​

\n

تدعم Madabina نصوص المنتجات بالفرنسية والإنجليزية والعربية. أضف اللغات التي تريد عرضها وراجع النص في المتجر العام. اختر تصنيفاً يصف المنتج لمساعدة العملاء على تصفح المنتجات المرتبطة.

\n

عاين الصفحة العامة​

\n

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

\n

لخطوات التاجر بالتفصيل، راجع دليل منتجات ومخزون Madabina، ثم أنشئ متجرك على Madabina.

", "url": "https://blog.madabina.com/ar/articles/sellers/product-page-checklist", "title": "قائمة مراجعة صفحة المنتج: الاسم والصور والسعر والمخزون", "summary": "خطوات عملية لتوضيح معلومات المنتجات والحفاظ على اتساقها في متجرك الإلكتروني.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "فريق تحرير Madabina", "url": "https://madabina.com" }, "tags": [ "للتجار" ] }, { "id": "https://blog.madabina.com/ar/articles/developers/rest-api-integration", "content_html": "

تتيح واجهة Madabina REST ذات الإصدارات للتكاملات المصادق عليها استخدام موارد التاجر مثل المنتجات والطلبات. ابدأ بعقد API المنشور قبل كتابة الطلبات؛ فهو يحدد الحقول والاستجابات وقواعد التحقق الحالية.

\n

ابدأ بعقد API​

\n

عنوان API الأساسي للإنتاج هو https://madabina.com/api/v1. تُعد واجهة API التفاعلية ووثيقة OpenAPI المرجعين الأساسيين للمسارات المتاحة ومخططات الطلبات.

\n

تشرح الوثائق مصادقة التاجر والموارد المتاحة للحساب المصادق عليه. تتطلب المسارات الخاصة رمز Bearer صالحاً، وتقتصر الموارد على المتاجر التي يحق للتاجر إدارتها.

\n

أبقِ بيانات الاعتماد خارج شيفرة العميل​

\n

اتبع مسار المصادقة الموثق للحصول على رمز. أرسل رموز الوصول في ترويسة Authorization: Bearer … عبر HTTPS. خزّن بيانات الاعتماد والرموز في الجهة الخادمة بمكان مناسب، ولا تضعها في المستودع أو حزمة المتصفح أو السجلات.

\n

قبل تنفيذ تجديد الرمز أو تسجيل الخروج أو أي تعديل، راجع الحقول والسلوك الدقيق في مرجع API الحالي. فهذه التفاصيل جزء من عقد الواجهة وقد تتغير.

\n

ابدأ بطلب قراءة بسيط​

\n

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

\n

راجع حدود المتجر وآثار العمليات​

\n

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

\n

تابع بالمراجع الرسمية​

\n\n

تشرح المدونة مسار التكامل، أما مرجع API فيحدد المسارات والمعاملات والاستجابات بدقة.

", "url": "https://blog.madabina.com/ar/articles/developers/rest-api-integration", "title": "Madabina REST API: دليل التكامل الأول للمطورين", "summary": "تعرّف على عنوان Madabina REST API ومراجع المصادقة والخطوات الآمنة لبدء التكامل.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "فريق تحرير Madabina", "url": "https://madabina.com" }, "tags": [ "للمطورين" ] }, { "id": "https://blog.madabina.com/ar/articles/sellers/start-online-store-algeria", "content_html": "

\"تجهّز

\n

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

\n

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

\n

1. حدّد عرضك​

\n

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

\n

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

\n

2. جهّز صفحات منتجات واضحة​

\n

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

\n

يستطيع تجار Madabina إدارة تفاصيل المنتجات وترجماتها والمخزون وظهور المنتجات في المتجر. راجع دليل المنتجات والمخزون لمعرفة خطوات العمل الحالية.

\n

3. اجعل مسار الطلب مفهوماً​

\n

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

\n

قدّم طلباً تجريبياً قبل مشاركة رابط المتجر. تأكد من ظهوره في مساحة التاجر الصحيحة ومن وضوح رسالة التأكيد للعميل.

\n

4. اضبط خيارات التوصيل التي تستطيع تنفيذها​

\n

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

\n

راجع دليل إعداد المتجر والتوصيل لمعرفة إعدادات التاجر.

\n

5. أطلق المتجر ثم حسّن خطوة في كل مرة​

\n

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

\n

قائمة مراجعة الإطلاق​

\n\n

أنشئ حساب تاجر في Madabina لبدء إعداد متجرك.

", "url": "https://blog.madabina.com/ar/articles/sellers/start-online-store-algeria", "title": "إعداد متجر إلكتروني في الجزائر على Madabina: قائمة عملية", "summary": "حضّر متجر Madabina وكتالوج المنتجات ومسار الطلب وإعدادات التوصيل.", "date_modified": "2026-10-15T00:00:00.000Z", "author": { "name": "فريق تحرير Madabina", "url": "https://madabina.com" }, "tags": [ "للتجار" ] } ] }