处理预订请求

妥善处理预订请求，避免错误和损失。

此信息适用于：

快速住宿 API
快速汽车 API
快速飞行 API

**注意：**某些细节会因您实现的 API 而异。

网络设置

设计预订请求工作流程时，务必考虑如何应对网络问题。没有收到回复并不代表预订失败。如果在发出预订请求后但在收到回复之前发生基础设施问题，则旅客的预订可能仍然会在我们的系统中被收费和确认。基础设施问题包括：

网络连接断开（无响应）。
返回 Server-side 错误（HTTP 代码 500 或 503）。
检测到错误的网络网关（返回 HTTP 代码 502）。
检测到网络网关超时（返回 HTTP 代码 504）。
回复不符合 Rapid API 文档（消息中缺少关键元素）。
响应不是 JSON 格式（例如，响应消息是 HTML 格式）。
其他异常、错误、未知行为或中断。

发出“创建预订”请求后，应使用检索预订请求跟进，其中包括：

“创建预订”请求中使用的 affiliate_reference_id 的原始值和电子邮件地址。 OR
创建预订响应中返回的 itinerary_id和 links.retrieve.href的值。

注意：新创建的行程有时在创建时间和可以检索行程时间之间会有短暂的延迟。如果您在尝试检索已成功创建的行程时收到错误，或者如果您收到包含 itinerary_id和 creation_date_time的响应，请在 30 分钟后重试检索，然后联系我们的呼叫中心代理以获得进一步支持。

推荐的流程

始终发送 `affiliate_reference_id`

为每次预订生成唯一的affiliate_reference_id。如果重新发送相同的请求详情（例如由于尝试失败），则应使用相同的 affiliate_reference_id。这可以防止意外的重复预订。发送新的“创建预订”请求时，API 不会响应，直到预订被确认或拒绝。大多数响应会在几秒钟内返回。但是，少数预订可能需要几分钟的时间来处理和生成响应。

Rapid API 连接到外部系统，以便在 real-time 中进行预订。依赖系统包括酒店预订或接待系统、信用卡处理系统或欺诈检测系统。98% 的预订可在 30 秒内完成。但是，如果您在 90 秒后未收到预订响应，请使用与预订一起发送的相同 affiliate_reference_id，通过检索请求检查预订进度。如果预订仍在进行中或预订失败，您将收到 404 错误“使用提供的请求找不到行程”。收到此消息后，您应使用相同的 affiliate_reference_id 再次尝试预订请求。如果预订仍未完成，您将看到一个 400 错误，并显示消息“具有此联盟伙伴参考 ID 的行程已存在”。如果返回此错误，您可以再次检索预订以确认预订详细信息是否可供查看。

处理预订时，检索 API 可能会返回错误或不完整的响应。稍后重试检索预订调用可解决 99.99% 的错误。为应对性能下降的情况，请在联系我们寻求进一步支持之前，重试检索 30 分钟。

预订争议

如果您在预订过程中遇到超时、50x HTTP 代码错误或其他基础设施问题，请提供以下事务日志以便我们进行故障排除：

预订请求和响应（如有）。
在最后一次预订尝试后 30 分钟发送的检索预订请求和响应。

日志应包含请求和响应的 HTTP 标头。响应消息有一个 transaction-id 标头，可以帮助我们识别 Rapid API 交易。

阅读更多关于处理常见 Rapid API 错误的信息，包括 HTTP 错误响应示例、用于处理预订的伪代码以及附录中的用户界面示例。