等位名单载荷示例

BatchGetWaitEstimates

此示例说明了餐厅通常允许 2 到 10 之间的 party_size 值,但在收到请求时,系统无法再提供高于 7 的 party_size 值(例如接近打烊时间),并且 2 的 party_size 实际上不需要等待。

获取等待请求

{
  "merchant_id": "dining-1",
  "party_size": [2, 3, 4, 5, 6, 7, 8, 9, 10],
  "service_id": "reservation"
}

获取等待响应

{
  "waitlist_status": "OPEN",
  "wait_estimate": [
    { "party_size": 2, "wait_length": {} },
    { "party_size": 3, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 4, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 5, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 6, "wait_length": { "parties_ahead_count": 3 } },
    { "party_size": 7, "wait_length": { "parties_ahead_count": 3 } }
  ]
}

CreateWaitlistEntry

创建申请

{
  "idempotency_token": "14620365692592881354",
  "merchant_id": "dining-1",
  "party_size": 3,
  "service_id": "reservation",
  "user_information": {
    "family_name": "John",
    "given_name": "Smith",
    "telephone": "+81 80-1111-2222",
    "user_id": "123456789"
  }
}

创建回复

{ "waitlist_entry_id": "MYS-1668739060" }

GetWaitlistEntry

获取请求

{ "waitlist_entry_id": "MYS-1668739060" }

获取响应

{
  "waitlist_entry": {
    "wait_estimate": {
      "party_size": 3,
      "wait_length": { "parties_ahead_count": 3 }
    },
    "waitlist_entry_state": "WAITING",
    "waitlist_entry_state_times": { "created_time_seconds": 1234567890 }
  }
}

DeleteWaitlistEntry

删除请求

{ "waitlist_entry_id": "MYS-1668739060" }

删除回复

{}