BeMyGuest API对接步骤

我们尽可能把对接的步骤简单化

BeMyGuest API flow

API运作流程

请按照以下步骤操作。

  • 通过手动编写代码或使用我们的SDK来获取API中的数据
    • 熟悉BMG数据结构,Apiary解释了键值对。
    • 从端点 /config获取位置,类别和其他词典。
    • 从端点 /products获取产品
    • 从端点 /product-types - 获取实际出售的产品类型。
    • 结合订单选项 - 产品类型的动态字段。
    • 从端点 /product-types/{uuid}/price-lists获取产品价格
  • 缓存服务器上的数据并根据建议刷新它。
  • 注册webhooks,BMG将在重要事件发生时调用这些端点。
  • 在Demo服务器上创建订单
    • 在所选产品类型上创建订单之前,请在/product-types/{uuid}/price-lists/YYYY-MM-DD查看价格和可用性。
    • 在您创建订单并收取付款后,请在/bookings/{uuid}/confirm确认订单。
  • 下载电子凭证
    • 您将获得webhook调用'vouchers_ready'数据,并且还需要自行检查订单状态 /bookings/{uuid}
    • 不要共享API提供的电子凭证URL。您需要获得授权才能下载。
  • 处理错误讯息
    • 在调用API​​时,您需要能够完美地处理此处描述的错误。
  • 通过BMG对接和UA测试,以确保您可以使用所有产品设置。
    • 测试是一个任务列表,主要是对选定产品进行预订,具有不同的设置(时间段,预订选项,访客限制)。
  • API上线和开始销售

从这个端点/config,请求数据开始熟悉API的调用。.

/config