المطورون

تنبيهات Webhook

أرسل تنبيهات SellerLegend مثل فقدان صندوق الشراء والقوائم المعلقة وانخفاض المخزون مباشرة إلى أنظمتك الخاصة على شكل Webhooks موقّعة بتنسيق JSON، لتتمكن أداة الدردشة الخاصة بفريقك أو نظام الدعم أو أدواتك الداخلية من التعامل معها فور صدورها.

للمطورين جديد

ابدأ التجربة المجانية

POST https://hooks.example.com/sellerlegend

X-SellerLegend-Event: sl.loss_of_buybox

X-SellerLegend-Signature: t=1791969600,v1=5f2b…c9e1

{
  "event_id": "evt_8c1f…",
  "event_type": "sl.loss_of_buybox",
  "emitted_at": "2026-10-14T09:20:00+00:00",
  "account": { "marketplace": "ATVPDKIKX0DER", "currency": "USD" },
  "notification_type": "Loss Of Buybox",
  "data": { … }
}

200 OK · delivered on attempt 1

نظرة عامة

تتيح تنبيهات Webhook لـ SellerLegend إرسال التنبيهات التي تتلقاها بالفعل داخل التطبيق وعبر البريد الإلكتروني إلى عنوان ويب تتحكم فيه أنت أو المطوّر الخاص بك. عندما يصدر SellerLegend تنبيهاً، مثل فقدان صندوق الشراء أو تغيير في قائمة منتج أو قائمة معلقة أو انخفاض المخزون أو مرتجع أو فشل الاتصال بأمازون، فإنه يرسل طلب HTTPS POST بمحتوى JSON إلى كل نقطة نهاية مرتبطة بتلك القاعدة. ومن هناك يمكنك نشره في دردشة الفريق، أو فتح تذكرة دعم، أو تحديث لوحة معلومات داخلية، أو بدء أي سير عمل تبنيه. يستغرق الإعداد بضع دقائق من إعدادات الحساب ← الإشعارات: أضف نقطة نهاية باسم وعنوان يبدأ بـ https:// في تبويب الوجهات (Destinations)، وانسخ مفتاح التوقيع الخاص بها، ثم فعّل خيار Webhook في أي قاعدة إشعارات واختر نقطة النهاية. يمكن إرسال كل أنواع التنبيهات عبر Webhook، وتتيح لك كل قاعدة اختيار الحسابات التي تشملها. تحمل كل عملية إرسال نوع حدث ثابتاً مثل sl.loss_of_buybox، ومعرّف حدث فريداً، والحساب والسوق الصادر منهما التنبيه، وتفاصيل التنبيه. يتم توقيع كل طلب باستخدام HMAC-SHA256 بمفتاح فريد لكل نقطة نهاية مع طابع زمني، بحيث يتمكن نظامك من التأكد من أن الطلب صادر من SellerLegend ورفض الطلبات المُعاد إرسالها. ويمكن تدوير المفاتيح في أي وقت. إذا كانت نقطة النهاية متوقفة، يقوم SellerLegend بما يصل إلى خمس محاولات إرسال على مدى ساعتين ونصف تقريباً، ويلتزم بقيمة Retry-After عند تلقي استجابة 429، ويحتفظ بمعرّف الحدث نفسه في كل إعادة محاولة لتتمكن من تجاهل التكرارات. يتم إيقاف نقاط النهاية التي تفشل باستمرار، أو التي تفشل محاولاتها الخمس جميعها لعملية إرسال واحدة، تلقائياً، ويمكن إعادة تفعيلها من تبويب الوجهات بعد إصلاحها. يمكنك إضافة ما يصل إلى 25 نقطة نهاية، وتستمر تنبيهاتك الحالية داخل التطبيق وعبر البريد الإلكتروني في العمل كما هي تماماً. تتوفر وثائق عامة تتضمن تنسيق المحتوى الكامل وأمثلة التحقق من التوقيع بلغات Node.js وPython وPHP على docs.sellerlegend.com.

نظرة سريعة

كل الأنواع أنواع التنبيهات المشمولة

HMAC-SHA256 طلبات موقّعة

5 محاولات إعادة محاولة تلقائية

25 نقاط النهاية لكل حساب

مثالي لـ

تطوير الفرق التقنية فرق العمليات الوكالات

الفوائد الرئيسية

كل أنواع التنبيهات

أرسل عبر Webhook تنبيهات فقدان صندوق الشراء وتغييرات القوائم والقوائم المعلقة والمخزون وعودة التوفر والمرتجعات والتقييمات واقتراحات إعادة التخزين وطلبات العملاء المدرجين في قائمة المراقبة وكميات الطلب المفرطة وتقارير الاستيراد/التصدير وتنزيل فواتير الرسوم وفشل الاتصال بأمازون

طلبات موقّعة

يتم توقيع كل طلب باستخدام HMAC-SHA256 بمفتاح فريد لكل نقطة نهاية مع طابع زمني، ليتمكن نظامك من رفض الطلبات المُعاد إرسالها

إعادة محاولة تلقائية

ما يصل إلى خمس محاولات على مدى ساعتين ونصف تقريباً، مع الالتزام بقيمة Retry-After عند استجابات 429، ومعرّف الحدث نفسه في كل إعادة محاولة لتسهيل إزالة التكرار

قواعد تتحكم بها

اختر التنبيهات والحسابات التي تُرسل إلى كل نقطة نهاية، إلى جانب تنبيهاتك الحالية داخل التطبيق وعبر البريد الإلكتروني

حماية ذاتية لنقاط النهاية

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

وثائق جاهزة للمطورين

وثائق عامة تتضمن تنسيق المحتوى الكامل وأمثلة التحقق من التوقيع بلغات Node.js وPython وPHP

تريد رؤيته أثناء العمل؟

شاهد هذا في العرض التجريبي المباشر

ما الذي تتضمنه

طلب HTTPS POST بمحتوى JSON

يعمل مع كل أنواع الإشعارات

ما يصل إلى 25 نقطة نهاية لكل حساب

مفتاح توقيع خاص بكل نقطة نهاية

توقيع HMAC-SHA256 مع طابع زمني

تدوير مفتاح التوقيع

أنواع أحداث ثابتة (مثل sl.loss_of_buybox)

معرّف حدث فريد، وهو نفسه في كل إعادة محاولة

الحساب ومعرّف البائع والسوق والعملة في كل رسالة

ما يصل إلى 5 محاولات إرسال على مدى ساعتين ونصف تقريباً

الالتزام بقيمة Retry-After عند استجابات 429

إيقاف تلقائي لنقاط النهاية التي تفشل

إعادة التفعيل من تبويب الوجهات

اختيار الحسابات لكل قاعدة

يعمل إلى جانب التنبيهات داخل التطبيق وعبر البريد الإلكتروني

وثائق عامة مع أمثلة بلغات Node.js وPython وPHP

هل أنت مستعد للبدء مع تنبيهات Webhook؟

انضم إلى آلاف بائعي أمازون الناجحين الذين يستخدمون SellerLegend لتنمية أعمالهم.

ابدأ تجربتك المجانية لمدة 21 يومًا

لا حاجة لبطاقة ائتمان • وصول كامل لجميع الميزات • إلغاء في أي وقت

عرض خطط الأسعار استعرض حالات الاستخدام استكشف جميع الميزات