اتصال اختصاصی

API و وب‌هوک

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

API و وب‌هوکHooshtelهوشتل

رویدادهای مجاز سامانه و عملیات کسب‌وکار

مسئول
مهندس اتصال + مسئول فرایند کسب‌وکار
جهت و مجوز
تبادل رویداد مستند و عملیات تأییدشده
اطلاعات حاصل
مرجع یکتای رویداد، وضعیت عملیات، سامانه دریافت‌کننده

کاربرد مشخص این اتصال

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

داده موردنیاز مکالمه را نگاشت کنید.

با این فیلدها محدوده تبادل با سامانه منبع را مشخص کنید. نام نهایی فیلد، احراز هویت و جزئیات نشانی اتصال را سامانه منبع تعیین می‌کند. فقط اطلاعات لازم برای فرایند توافق‌شده را وارد کنید.

فیلد مرجعکاربردنقش در تبادل
event_idشناسه یکتای رویدادقرارداد مستند رویداد
conversation_idمرجع مکالمهقرارداد مستند رویداد
event_typeنوع مشخص رویداد کسب‌وکارقرارداد مستند رویداد
payloadحداقل داده موردنیاز سامانه دریافت‌کنندهقرارداد مستند رویداد

مرز دسترسی را روشن نگه دارید.

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

خواندن نتیجه، مجوز تغییر آن نیست. هر اقدام تغییردهنده را جداگانه بررسی کنید؛ از جمله چه کسی می‌تواند درخواست کند، نتیجه چگونه تأیید می‌شود و خطا چگونه مدیریت می‌شود.

یک استثنا برای آزمایش

یک رویداد دو بار می‌رسد. رفتار مستند سامانه دریافت‌کننده برای تکرار را بررسی کنید و مطمئن شوید فقط یک نتیجه کاری موردنظر ایجاد شده است.

مرور انتقال و بازیابی

پیش از فعال‌شدن اتصال.

  • مسئول منبع و تیم رسیدگی به خطا را مشخص کنید.
  • رکورد معتبر، شناسه ناشناخته و دسترسی ردشده را آزمایش کنید.
  • رفتار پایان مهلت و تحویل تکراری را بررسی کنید.
  • بررسی کنید اپراتور بدون گرفتن مجوز اضافه بتواند منبع را ببیند.
  • مسیر انتقال به انسان و بازگشت از تغییر را مستند کنید.
برای مسئول منبع آماده کنید

شرح اتصال شما

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

چک‌لیست متنی؛ بدون کلید اتصال یا داده مشتری.

اولین فرایند را آماده کنید

محدوده‌ای روشن.
شروعی سنجیده.

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

هوشتل