ابنِ تكاملاً مع متجر على eMatjarak

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

ثلاثة أشياء تحصل عليها

  • مفتاح API يصدره التاجر من لوحة تحكمه، محدود بمتجره فقط.
  • واجهة GraphQL للمنتجات والطلبات والزبائن والمخزون.
  • ويب هوك صادرة، موقّعة بـ HMAC، مع إعادة محاولة عند الفشل.

ما هو غير متوفر بعد

لا يوجد متجر تطبيقات. لا يمكنك تسجيل تطبيق OAuth، ولا توجد آلية تثبيت لكل متجر، ولا قائمة يتصفحها التجار. التكامل اليوم هو شيء يطلبه منك تاجر محدد ويمنحك مفتاحاً له.

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

كيف تبدأ

  1. أنشئ متجراً مجانياً خاصاً بك — هذا هو بيئة الاختبار. يستغرق أقل من دقيقة ويمكنك حذفه لاحقاً.
  2. أضف منتجات تجريبية من الإعدادات ← المطوّر، لتصبح لديك بيانات تقرأها.
  3. نفّذ طلباً تجريبياً واحداً على متجرك — يستغرق نصف دقيقة ويُطلق حدث order.placed الذي تبني عليه غالباً.
  4. أصدر مفتاح API واستدعِ الواجهة (انظر: المصادقة).
  5. سجّل رابط ويب هوك وتحقق من التوقيع (انظر: ويب هوك).

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