خانه
بازگشت به مستندات

وب‌هوک‌ها

هر اشتراک منطبق، رویداد را با تحویل امضاشده و صف‌بندی‌شده دریافت می‌کند و خطاها دوباره تلاش می‌شوند.

وب‌هوک، رویدادهای این سامانه را به نشانی شما در سیستم دیگری می‌فرستد.

تحویل در صف است، نه در لحظه

رویداد بلافاصله فرستاده نمی‌شود؛ در صف قرار می‌گیرد و کارگر پس‌زمینه آن را تحویل می‌دهد. پس یک تأخیر کوتاه طبیعی است، و کندی سیستم مقصد کار خود سامانه را کند نمی‌کند.

سه تلاش، با فاصلهٔ فزاینده

اگر مقصد جواب موفق ندهد، تحویل دوباره تلاش می‌شود — با فاصله‌های یک دقیقه، پنج دقیقه و پانزده دقیقه. بعد از آن تحویل ناموفق ثبت می‌شود.

یعنی قطعی کوتاه سمت شما باعث از دست رفتن رویداد نمی‌شود؛ اما قطعی طولانی می‌شود.

هر درخواست امضا دارد

هر تحویل با رمز همان اشتراک امضا می‌شود و امضا در سرآیند فرستاده می‌شود. سمت خودتان باید همان امضا را از روی بدنهٔ دریافتی دوباره بسازید و مقایسه کنید.

بدون این بررسی، هرکسی که نشانی شما را بداند می‌تواند رویداد جعلی بفرستد.

نشانی مقصد محدودیت دارد

نشانی باید واقعاً بیرونی باشد. نشانی‌هایی که به خود سرور یا به شبکهٔ داخلی اشاره می‌کنند پذیرفته نمی‌شوند — این محافظت در برابر استفاده از وب‌هوک برای رسیدن به منابع داخلی است.

اشتراک‌های منطبق، رویداد را در سطح نصب می‌گیرند

اشتراک‌ها با نام رویداد تطبیق داده می‌شوند، نه با سایت. هر اشتراک منطبق در همین نصب رویداد را دریافت می‌کند. دادهٔ خروجی دیگر فیلد قدیمی انتساب سایت را ندارد و امضا دقیقاً روی بدنهٔ نهایی محاسبه می‌شود.

فهرست تحویل‌ها، منبع حقیقت است

برای هر تحویل، کد پاسخ، شمارهٔ تلاش و خطا ثبت می‌شود. وقتی طرف مقابل می‌گوید «چیزی دریافت نکردیم»، جواب همین‌جاست.