CreateBooking Ready

若要完成 CreateBooking 准备就绪里程碑任务,您需要成功构建并交付 CreateBooking 方法。当用户尝试创建预订时,系统会调用此方法。如果成功创建预订,响应会包含一个唯一的 booking_id,用于在未来的请求或更新中引用该预订。

CreateBooking 任务要求

  • 10 次成功的 CreateBooking 响应,错误率低于 10%。

CreateBooking 基础知识

当用户发起预订时,系统会向合作伙伴的预订服务器发送 CreateBooking 请求。对请求的响应会指明预订成功还是失败。如果预订失败,响应需要包含失败的业务逻辑错误。例如,相应空档已不可用,或者已被同一用户预订。

用户创建预订后,Google 会向您发送用户的名字、姓氏、电话号码和电子邮件地址。如需了解详情,请参阅账号匹配和创建政策

幂等性

通过网络进行的通信并非始终可靠,如果 Google 未收到任何响应,可能会重试 HTTP 请求。因此,更改状态的所有方法都必须具有幂等性:

  • CreateBooking
  • UpdateBooking

对于除 UpdateBooking 之外的每个请求消息,均包含幂等性令牌以标识身份唯一的请求。这使您能够区分重新提交的 REST 调用(旨在创建单个请求)和两个单独的请求。UpdateBooking 的相应预订条目 ID 有助于唯一标识它们,因此这些请求中不包含幂等性令牌。

以下是一些有关预订服务器如何处理幂等性的示例:

  • 成功的 CreateBooking HTTP 响应包括创建的预订。在某些情况下,付款会作为预订流程的一部分进行处理。如果再次收到相同的 CreateBookingRequest(具有同一 idempotency_token),则必须返回相同的 CreateBookingResponse。系统不会再次创建预订,且仅向用户收取一次费用(如适用)。

幂等性要求适用于更改状态的所有方法。