مفهوم

تابع سرور و وب‌هوک؛ اتصال بیرونی را درست تعریف کن

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

تیم محصول و مستندات کُندا · بازبینی متن: ۲۸ مهر ۱۴۰۵

در این راهنما

#تابع سرور و وب‌هوک یکی نیستند

تابع سرور منطق را بیرون از مرورگر اجرا می‌کند. وب‌هوک پیام رویداد بین سرویس‌هاست. وجود یک الگوی تابع به معنی وجود سرویس آمادهٔ وب‌هوک خروجی با تضمین تلاش مجدد نیست.

#اتصال را مشخص تعریف کن

  • چه رویدادی باعث ارسال می‌شود؟
  • چه داده‌ای اجازهٔ خروج دارد؟
  • راز و امضا کجا بررسی می‌شود؟
  • موفقیت، شکست و تکرار همان رویداد چگونه تشخیص داده می‌شود؟

#قبل از دادهٔ واقعی

با محیط آزمایشی سرویس مقصد و شناسهٔ رویداد ساختگی شروع کن. پاسخ نامعتبر و قطع ارتباط را هم بررسی کن. تلاش مجدد نباید یک پرداخت یا رکورد را دوبار بسازد.

#از تعریف اتصال تا پیاده‌سازی

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

#نمونه: ارسال درخواست مشاوره به سرویس دیگر

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

حالتانتظار طراحی
دریافت معتبریک اثر مشخص و قابل پیگیری ثبت شود
دریافت تکراریاثر قبلی دوباره ایجاد نشود
پاسخ نامعلوموضعیت نامعلوم ثبت شود؛ موفقیت قطعی نمایش داده نشود
امضای نامعتبررویداد پذیرفته نشود و دادهٔ خصوصی برنگردد

#اگر به نتیجه نرسیدی

نشانهاقدام بعدی
رویداد دوبار پردازش می‌شودشناسهٔ یکتای رویداد و جلوگیری از اثر تکراری را در قرارداد اتصال بررسی کن.
مقصد پاسخ نمی‌دهدوضعیت ارسال را ثبت کن؛ تلاش مجدد خودکار را بدون قرارداد مشخص فرض نکن.

قدم بعد

ادامهٔ مسیرت

فهرست راهنما
کپی دستی متن

کپی خودکار انجام نشد. متن را انتخاب و کپی کن، یا فایل Markdown را دانلود کن.