استخدام بيئة اختبار الـ API (إعدادات المطوّر)

بيئة اختبار الـ API هي صندوق تجارب تفاعلي لواجهة برمجة eGrow للمطوّرين. تختار إجراءً، وتملأ نموذجاً بسيطاً، فيبني لك eGrow طلب الـ API بالضبط — كأمر cURL جاهز للنسخ أو استعلام GraphQL — ثم يتيح لك تشغيله ورؤية الاستجابة الحيّة. إنها أسرع طريقة لفهم الواجهة واختبارها قبل أن تكتب سطراً واحداً من كود التكامل. افتحها من الإعدادات ← المطوّر ← بيئة الاختبار على https://v2.egrow.com/settings/developer/playground.

كيف تُنظَّم بيئة الاختبار

تنقسم الشاشة إلى قسمين:

• في جانب، نموذج للإجراء الذي اخترته — المدخلات التي يحتاجها الطلب.
• في الجانب الآخر، لوحة الطلب والاستجابة الحيّة التي تتحدّث أثناء ملئك النموذج.

في الأعلى تختار الإجراء الذي تريد تجربته. وهناك ثلاثة:

الإجراء 1: إرسال رسالة

أرسِل رسالةً إلى عميل عبر قناة مربوطة — تماماً ما سيفعله تكاملك للوصول إلى شخص على واتساب. املأ:

• الاتصال (مطلوب) — من أي قناة مربوطة (مثل رقم واتساب) تُرسل.
• المستلم (مطلوب) — العميل المُراسَل.
• نوع الرسالة — نصّ، أو صورة، أو فيديو، أو بريد إلكتروني.
• الموضوع (للبريد فقط) ونصّ الرسالة، أو رابط/رفع وسائط للصورة والفيديو.

الإجراء 2: إضافة طلب

أنشئ طلباً عبر الواجهة — الاستدعاء نفسه الذي يستخدمه تكامل متجر لدفع طلبات جديدة إلى eGrow. يحاكي النموذج طلباً كاملاً وهو مقسّم إلى أقسام قابلة للطيّ كي لا يكون مرهقاً:

• تفاصيل الطلب — رقم الطلب، والمعرّف الخارجي، ورابط السلّة المتروكة، ونوع الطلب، والمسار/المرحلة، والحالة المالية، والمتجر، وقناة البيع.
• العميل — تفاصيل المشتري.
• عناصر الطلب — المنتجات في الطلب.
• الخصومات والتسعير.
• عنوان الشحن، وعنوان الفوترة، وجهة الاتصال.
• UTM — معاملات نسب الحملة.

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

الإجراء 3: تحديث المرحلة

انقل طلباً موجوداً إلى مرحلة مختلفة في مسارك — الاستدعاء الذي سيجريه نظام خارجي لإبقاء eGrow متزامناً (مثلاً وسم طلب كمشحون). اختر الطلب والمرحلة الهدف.

قراءة الطلب وتشغيله

أثناء ملئك النموذج، تُظهر لوحة الطلب الاستدعاء بطريقتين — بدّل بينهما:

• cURL — أمر curl -X POST كامل موجّه إلى نقطة نهاية الواجهة، مع ترويسة المصادقة وبياناتك. انسخه فيعمل كما هو في طرفيّتك.
• GraphQL — مستند الاستعلام/الطفرة الأساسي مع متغيّراته، إن فضّلت العمل على هذا المستوى.

اضغط تشغيل لتنفيذ الطلب على الواجهة الحيّة ورؤية الاستجابة بصيغة JSON أسفله مباشرةً — الاستجابة نفسها التي سيتلقّاها تكاملك. ويمكنك نسخ الاستجابة أيضاً، وتبديل سِمة كود فاتحة/داكنة لسهولة القراءة.

من بيئة الاختبار إلى الإنتاج

بمجرد نجاح استدعاء هنا، انقله إلى كودك الخاص:

1. انسخ cURL (أو مستند GraphQL ومتغيّراته).
2. استبدل مصادقة بيئة الاختبار بـمفتاح API الشخصي الخاص بك من الإعدادات ← المطوّر ← مفتاح API كرمز Bearer.
3. أرسله من تطبيقك، وتعامل مع استجابة JSON بالطريقة نفسها التي رأيتها هنا.

من يستخدم هذا: مطوّرك ووكيل الترميز الذكي لديك

بيئة الاختبار هي حيث تكتشف الاستدعاءات وتختبرها. ثم هناك طريقتان لـاستخدام واجهة eGrow عملياً.

مطوّرك — واجهة REST/GraphQL

يبني المطوّر مباشرةً على الواجهة التي اختبرتها للتوّ:

1. النمذجة في بيئة الاختبار — اجعل الاستدعاء يعمل وانسخ cURL الخاص به (أو مستند GraphQL + المتغيّرات).
2. المصادقة بـمفتاح API شخصي من الإعدادات ← المطوّر ← مفتاح API، يُرسَل كرمز Bearer — أو، لتطبيق طرف ثالث يعمل على حسابات أخرى، تطبيق OAuth من تبويب تطبيقات OAuth.
3. استدعِ نقطة النهاية من كوده وتعامل مع استجابة JSON، تماماً كما رأيت في بيئة الاختبار.

كل ما تفعله بيئة الاختبار — إرسال الرسائل، وإنشاء الطلبات، ونقل المراحل — متاح برمجياً، فيستطيع مطوّرك ربط eGrow بموقعك، أو نظام ERP، أو أي خلفية.

وكيل الترميز الذكي لديك — خادم MCP

إن كنت تستخدم مساعد ترميز ذكياً (Claude، وCursor، وما شابه)، فإن eGrow يوفّر خادم MCP مخصّصاً كي يتحدّث الوكيل إلى حسابك مباشرةً — يقرأ بياناتك الحقيقية ويتصرّف فيها عبر مجموعة أدوات آمنة ومنظّمة. اضبطه من الإعدادات ← المطوّر ← MCP (https://v2.egrow.com/settings/developer/mcp).

• عنوان الخادم — https://mcp.egrow.com/mcp (نقل HTTP).
• المصادقة — OAuth (يسجّل الوكيل دخوله إلى eGrow، دون لصق شيء) أو رمز (مفتاح API الشخصي الخاص بك). يمنحك تبويب MCP مقتطف إعداد جاهزاً للصقه في إعدادات وكيلك، مثلاً:

  {
   "mcpServers": {
   "egrow": { "type": "http", "url": "https://mcp.egrow.com/mcp" }
   }
  }

  وللمحرّرات التي تحتاج جسراً محلياً، يوفّر أيضاً أمر stdio: npx -y mcp-remote https://mcp.egrow.com/mcp.
• ما يستطيع الوكيل فعله — نحو 40 أداةً مجمّعةً حسب المجال: الطلبات (11)، والعملاء (10)، والمنتجات (7)، والاكتشاف (4)، والتحليلات (3)، ومخرج الطوارئ (3)، والمسارات (2). فيمكنك ببساطة أن تسأل بلغة طبيعية: «كم طلباً سُلِّم الأسبوع الماضي؟»، أو «أنشئ طلباً لهذا العميل»، أو «أي المنتجات له أفضل معدّل تسليم؟» — فيشغّل الوكيل الأدوات الصحيحة على حسابك.

ما التالي

اضبط المصادقة في الإعدادات ← المطوّر ← مفتاح API، واستكشف التدفّقات المدفوعة بالأحداث عبر الأتمتة، واربط منظومتك من التكاملات والمطوّرون.