پیکربندی وب‌هوک‌ها

وب‌هوک‌ها به سیستم‌های بیرونی اجازه می‌دهند بلافاصله پس از هر تغییری در USystems Atlas واکنش نشان دهند، بدون آنکه نیاز باشد به‌طور مداوم از API استعلام بگیرند. شما تنها یک آدرس HTTPS ثبت می‌کنید و Atlas به محض وقوع رویداد مربوطه، بستهٔ داده را به آن ارسال می‌کند.

برای شروع، به بخش Settings > Integrations > Webhooks بروید و روی Add Endpoint کلیک کنید. یک آدرس HTTPS در دسترس عموم وارد کنید و رویدادهایی را که برایتان اهمیت دارند انتخاب کنید، مانند patient.created، patient.updated، invoice.paid یا user.deactivated. می‌توانید در یک نقطهٔ پایانی به هر تعداد رویداد که نیاز دارید مشترک شوید یا آن‌ها را میان چند نقطهٔ پایانی تقسیم کنید.

هر درخواست وب‌هوک شامل هدر X-Atlas-Signature است، هشی از بستهٔ داده که با کلید امضای نمایش داده‌شده در صفحهٔ جزئیات نقطهٔ پایانی تولید شده است. سرور دریافت‌کنندهٔ شما باید این هش را دوباره محاسبه کند و هر درخواستی که امضایش مطابقت نداشته باشد را رد کند، که این کار شما را در برابر درخواست‌های جعلی محافظت می‌کند.

اگر ارسال با شکست مواجه شود، Atlas تا ۲۴ ساعت با فاصله‌های زمانی فزاینده دوباره تلاش می‌کند، و گزارش ارسال هر تلاش را همراه با پاسخی که سرور شما داده نشان می‌دهد. از این گزارش برای رفع سریع مشکلات آدرس‌های نادرست یا از‌کاراُفتادگی غیرمنتظره استفاده کنید.