التسليم وإعادة المحاولة

تجري أوكتين حتى 3 محاولات لكل تسليم، لكل منها مهلة 500 ملّي ثانية، وتعطّل الويب هوك بعد 50 فشلًا متتاليًا أو 3 أيام من الفشل. معرّف التسليم هو نفسه في كل محاولة، فامنع التكرار به.

التسليم الواحدCopy Anchor Link

لكل معاملة ولكل مفتاح من مفاتيحك له عنوان ويب هوك، تجري أوكتين تسليمًا واحدًا:

المهلة قصيرة عمدًا. يجب ألا ينفذ المعالج لديك أي عمل قبل الرد: لا كتابة في قاعدة بيانات، ولا استدعاءات لواجهات أخرى، ولا تنزيل صور. الأمران الوحيدان اللذان يُنفَّذان قبل الرد هما التحقق من التوقيع وتمرير الحدث الخام إلى طابور أو مهمة خلفية، ثم إعادة 2xx.

كم مرة تعيد أوكتين المحاولة؟Copy Anchor Link

يُعاد التسليم الفاشل حتى 3 محاولات إجمالًا، متباعدة تقريبًا كالتالي:

ترسل كل محاولة الجسم نفسه ومعرّف التسليم id نفسه؛ ولا يتغير سوى الطابع الزمني للتوقيع وروابط الصور (المعاد توقيعها، صالحة 24 ساعة).

بعد فشل المحاولة الثالثة يُسجَّل التسليم فاشلًا من جانب أوكتين مع الاستجابة التي أعادتها نقطة النهاية لديك. يمكن لأوكتين إعادة تسليم حدث فاشل عند الطلب. تحمل إعادة التسليم id الأصلي.

متى يُعطَّل الويب هوك؟Copy Anchor Link

إذا استمر فشل التسليمات، يُعطَّل الويب هوك تلقائيًا بعد 50 تسليمًا فاشلًا متتاليًا أو 3 أيام من الفشل المستمر، أيهما أسبق. تُخطَر أنت وفريق عمليات أوكتين بالبريد الإلكتروني.

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

عدم التكرارCopy Anchor Link

تعني إعادة المحاولة وإعادة التسليم أن نقطة النهاية لديك قد تستقبل الحدث نفسه أكثر من مرة. معرّف التسليم id (الموجود أيضًا في X-Octane-Delivery) حتمي لمعاملة ومفتاح معينين، لذا فهو مفتاح آمن لمنع التكرار:

async function handle(event) {
  const inserted = await db.execute(
    'INSERT INTO octane_events (delivery_id, received_at) VALUES ($1, now()) ON CONFLICT DO NOTHING',
    [event.id],
  );
  if (inserted.rowCount === 0) return; // already processed

  await processTransaction(event.data.transaction);
}

بدلًا من ذلك، نفّذ upsert على data.transaction.id: لا تُرسل المعاملة إلا مرة واحدة لكل مفتاح، فأي تسليم ثانٍ بمعرّف المعاملة نفسه هو دائمًا إعادة محاولة.

هل تُسلَّم الأحداث بالترتيب؟Copy Anchor Link

تُسلَّم الأحداث وفق تأكيد المعاملات، لكن الترتيب بين الأحداث غير مضمون، خاصة مع إعادة المحاولات. استخدم data.transaction.created_at أو confirmed_at إذا كان الترتيب يهمك.

المراقبة من جانبكCopy Anchor Link

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