رابط Postback التابع: ما فائدته لصانعي المحتوى

أرادت صانعة محتوى تابعة من أنقرة أن تتلقى قناتها على Discord إشعاراً فورياً عند كل عمولة جديدة خلال جلسة التدريب المباشرة. الحل جاء مع ميزة postback URL في Phase 3.

كيف يعمل

في لوحة التحكم افتح Settings → Postback URL. الصق endpoint الخاص بك، فعّل toggle، واضغط Generate Signing Secret. السر سلسلة hex من 32 حرفاً تُعرض مرة واحدة فقط؛ بعد ذلك يعيش كـ hash في قاعدة البيانات.

عند كل حدث — created، refunded، أو released — يرسل العامل POST مع header X-thMenu-Signature: sha256=<hmac>. تحسب HMAC على جانبك وتقارن بـ constant-time.

سيناريوهات حقيقية

أقوى نمط للمبدعين هو webhook Discord للتفاعل مع المجتمع. بثّت صانعة المحتوى من أنقرة مباشرة لأعضائها الـ 320: "شخص ما استخدم كودي للتو — 47 USD عمولة". تضاعف التفاعل ثلاث مرات خلال ساعة.

وجهات أخرى: بوتات Slack، CRMs شخصية HubSpot أو Notion، تدفقات Zapier/Make إلى Google Sheets، قنوات Telegram، وملخصات بريدية للمحاسب. كل نوع حدث يمكن معالجته بشكل مختلف.

الموثوقية

إذا لم يرد endpoint بـ 2xx خلال 5 ثوانٍ، يسجل العامل الفشل في affiliate_postback_log. كل ساعة يعيد cron المحاولة حتى 5 مرات مع backoff أسي (1د، 5د، 30د، 2س، 6س). بعد الفشل الخامس يُعتبر الحدث ميتاً.

لهذا يجب أن يكون endpoint idempotent. UPSERT بـ event_id؛ عند التكرار أرجع 200 دون إعادة إشعار. ارفض أيضاً الطلبات بتاريخ أقدم من 5 دقائق لتخفيف هجمات replay.

الأسئلة الشائعة

هل الميزة مدفوعة؟ لا، مجانية لكل المنتسبين النشطين.

هل يوجد وضع اختبار؟ نعم، زر "Send Test Event" في اللوحة.

إذا فقدت السر؟ أعد توليده؛ يُلغى القديم فوراً.

هل وجدت هذا مفيداً؟ شاركه.