برای تکمیل تکلیف نقطه عطف CreateBooking
Ready، باید روش CreateBooking
با موفقیت بسازید و تحویل دهید. این روش زمانی فراخوانی می شود که کاربر سعی می کند رزرو ایجاد کند. اگر رزرو موفقی ایجاد شود، پاسخ شامل یک booking_id
منحصر به فرد برای ارجاع به رزرو برای درخواستها یا بهروزرسانیهای آینده است.
الزامات کار CreateBooking
- 10 پاسخ موفق
CreateBooking
با نرخ خطای کمتر از 10٪.
ایجاد اصول اولیه رزرو
هنگامی که یک کاربر رزرو را آغاز می کند، یک درخواست CreateBooking
به سرور رزرو شریک ارسال می شود. پاسخ به درخواست نشان دهنده موفقیت آمیز بودن رزرو یا شکست رزرو است. اگر رزرو شکست خورده باشد، پاسخ باید شامل خطای منطق تجاری برای شکست باشد. به عنوان مثال، اسلات در دسترس نیست یا اسلات قبلاً توسط همان کاربر رزرو شده است.
وقتی کاربر رزروی را ایجاد میکند، Google نام، نام خانوادگی، شماره تلفن و ایمیل کاربر را برای شما ارسال میکند. برای اطلاعات بیشتر، به سیاست تطبیق و ایجاد حساب مراجعه کنید.
ناتوانی
ارتباط از طریق شبکه همیشه قابل اعتماد نیست و اگر پاسخی دریافت نشد، Google میتواند درخواستهای HTTP را دوباره امتحان کند. به همین دلیل، همه روشهایی که حالت جهش پیدا میکنند باید فاقد قدرت باشند:
-
CreateBooking
-
UpdateBooking
برای هر پیام درخواستی، به جز UpdateBooking
، نشانههای idempotency برای شناسایی منحصر به فرد درخواست گنجانده شده است. این به شما امکان می دهد بین یک تماس REST تکرار شده، با هدف ایجاد یک درخواست واحد و دو درخواست جداگانه تمایز قائل شوید. شناسههای ورودی رزرو مربوطه UpdateBooking
به شناسایی منحصربهفرد آنها کمک میکند، بنابراین هیچ نشانه ضعف در درخواستهای آنها گنجانده نمیشود.
در زیر چند نمونه از نحوه برخورد سرورهای رزرو با عدم توانایی ارائه شده است:
یک پاسخ موفق
CreateBooking
HTTP شامل رزرو ایجاد شده است. در برخی موارد، پرداخت به عنوان بخشی از جریان رزرو پردازش می شود. اگر همانCreateBookingRequest
برای بار دوم با همانidempotency_token
دریافت شود، همانCreateBookingResponse
باید برگردانده شود. رزرو دوم ایجاد نشده است و در صورت وجود، دقیقاً یک بار از کاربر هزینه دریافت می شود.
شرط ناتوانی برای همه روش هایی که حالت جهش پیدا می کنند اعمال می شود.
، برای تکمیل تکلیف نقطه عطف CreateBooking
Ready، باید روش CreateBooking
با موفقیت بسازید و تحویل دهید. این روش زمانی فراخوانی می شود که کاربر سعی می کند رزرو ایجاد کند. اگر رزرو موفقی ایجاد شود، پاسخ شامل یک booking_id
منحصر به فرد برای ارجاع به رزرو برای درخواستها یا بهروزرسانیهای آینده است.
الزامات کار CreateBooking
- 10 پاسخ موفق
CreateBooking
با نرخ خطای کمتر از 10٪.
ایجاد اصول اولیه رزرو
هنگامی که یک کاربر رزرو را آغاز می کند، یک درخواست CreateBooking
به سرور رزرو شریک ارسال می شود. پاسخ به درخواست نشان دهنده موفقیت آمیز بودن رزرو یا شکست رزرو است. اگر رزرو شکست خورده باشد، پاسخ باید شامل خطای منطق تجاری برای شکست باشد. به عنوان مثال، اسلات در دسترس نیست یا اسلات قبلاً توسط همان کاربر رزرو شده است.
وقتی کاربر رزروی را ایجاد میکند، Google نام، نام خانوادگی، شماره تلفن و ایمیل کاربر را برای شما ارسال میکند. برای اطلاعات بیشتر، به سیاست تطبیق و ایجاد حساب مراجعه کنید.
ناتوانی
ارتباط از طریق شبکه همیشه قابل اعتماد نیست و اگر پاسخی دریافت نشد، Google میتواند درخواستهای HTTP را دوباره امتحان کند. به همین دلیل، همه روشهایی که حالت جهش پیدا میکنند باید فاقد قدرت باشند:
-
CreateBooking
-
UpdateBooking
برای هر پیام درخواستی، به جز UpdateBooking
، نشانههای idempotency برای شناسایی منحصر به فرد درخواست گنجانده شده است. این به شما امکان می دهد بین یک تماس REST تکرار شده، با هدف ایجاد یک درخواست واحد و دو درخواست جداگانه تمایز قائل شوید. شناسههای ورودی رزرو مربوطه UpdateBooking
به شناسایی منحصربهفرد آنها کمک میکند، بنابراین هیچ نشانه ضعف در درخواستهای آنها گنجانده نمیشود.
در زیر چند نمونه از نحوه برخورد سرورهای رزرو با عدم توانایی ارائه شده است:
یک پاسخ موفق
CreateBooking
HTTP شامل رزرو ایجاد شده است. در برخی موارد، پرداخت به عنوان بخشی از جریان رزرو پردازش می شود. اگر همانCreateBookingRequest
برای بار دوم با همانidempotency_token
دریافت شود، همانCreateBookingResponse
باید برگردانده شود. رزرو دوم ایجاد نشده است و در صورت وجود، دقیقاً یک بار از کاربر هزینه دریافت می شود.
شرط ناتوانی برای همه روش هایی که حالت جهش پیدا می کنند اعمال می شود.