ارسال رویدادها به سامانه‌ی خودتان با webhook

یک وب‌هوک به IDup اجازه می‌دهد آدرس وب شما را در لحظه‌ای که چیزی اتفاق می‌افتد فراخوانی کند، مثلاً زمانی که یک فاکتور پرداخت می‌شود. هر تحویل امضا شده و در صورت عدم پاسخ سیستم شما تکرار می‌شود.

افزودن یک نقطه پایانی

1. باز کنید Webhooks زبانه و فشار دهید افزودن نقطه پایانی.
2. وارد کردن یک نام و URL. این باید به صورت عمومی قابل دسترسی باشد. آدرس‌های داخل یک شبکه خصوصی به دلایل امنیتی رد می‌شوند.
3. تیک بزنید رویدادها که می‌خواهید.
4. اختیاری: انتخاب یک کلید API. نقطه پایانی سپس فقط رویدادهایی را دریافت می‌کند که این کلید ممکن است بخواند.
5. فشار دهید ذخیره. IDup نشان می‌دهد راز امضای شما یک بار. آن را در جای امن نگه دارید.

رویدادها

• فاکتور ایجاد شد, فاکتور پرداخت شد, پرداخت دریافت شد
• مشتری جدید, تماس جدید, سرنخ جدید, تیکت جدید
• پیشنهاد پذیرفته شد — پیشنهاد قیمتی که مشتری پذیرفت

هر تحویل دارای سه سربرگ است: نام رویداد، شماره تحویل و امضا. یک تلاش مجدد همان شماره تحویل را حفظ می‌کند، بنابراین سیستم شما می‌تواند تکراری‌ها را شناسایی کند.

امضا را بررسی کنید

سیستم شما باید یک HMAC-SHA256 روی زمان و بدنه خام با راز شما محاسبه کند، آن را با امضا مقایسه کند و زمانی قدیمی‌تر از 5 دقیقه را رد کند. فشار دهید تأیید امضا و نمونه‌ها برای کد آماده.

آزمایش، توقف و تمدید

• ارسال آزمایشی یک رویداد آزمایشی می‌فرستد و کد HTTP و زمان صرف‌شده را نشان می‌دهد.
• توقف تحویل‌ها را متوقف می‌کند؛ فعال‌سازی آن‌ها را دوباره شروع می‌کند.
• راز رول یک راز جدید ایجاد می‌کند. راز قدیمی بلافاصله از کار می‌افتد.
• حذف نقطه پایانی را حذف می‌کند. گزارش آن حفظ می‌شود.

تلاش‌های مجدد و گزارش

آدرس شما باید ظرف ۵ ثانیه با کد 2xx پاسخ دهد. ریدایرکت‌ها دنبال نمی‌شوند. در صورت شکست، IDup پس از ۱ دقیقه، ۵ دقیقه، ۳۰ دقیقه، ۲ ساعت و ۱۲ ساعت دوباره تلاش می‌کند. پس از تلاش ششم، تحویل علامت‌گذاری می‌شود تسلیم شده.

گزارش هر تلاش را با رویداد، نقطه پایانی، شماره تلاش، کد HTTP، مدت و ابتدای پاسخ نشان می‌دهد. وضعیت این است: در انتظار, تحویل داده شد, ناموفق یا تسلیم شده. استفاده کنید ارسال مجدد برای ارسال دوباره‌ی یک تحویل.