处理预订请求
正确处理预订请求，避免出错和损失至关重要。
概述
合理设计预订请求工作流程以容忍网络问题，这一点非常重要。不要将收不到响应解读为预订失败的迹象。如果在发送预订请求之后、收到响应之前的这段时间里，出现了基础设施问题，客户的预订在 Rapid 系统中仍有可能付费成功并得到确认。基础设施问题包括：
- 网络连接丢失（例如，未返回响应）。
- 返回服务器端错误（例如，返回 HTTP 代码 500 或 503）。
- 观察到错误的网络网关（例如，返回 HTTP 代码 502）。
- 观察到网络网关超时（例如，返回 HTTP 代码 504）。
- 响应未遵循 Rapid 文档的规定（例如，响应消息中缺少关键元素）。
- 响应消息未采用 JSON 格式（例如，响应消息采用了 HTML 格式）。
- 其他异常、错误、未知行为或中断。
发出“创建预订”请求后，应使用检索预订请求跟进，其中包括：
- “创建预订”请求中使用的
affiliate_reference_id的原始值和电子邮件地址。 - 或者，“创建预订”响应中返回的
itinerary_id和links.retrieve.href的值。
然后可以检索预订的状态，但新预订的结果最多可能会延迟 90 秒。
推荐的流程
始终发送 affiliate_reference_id
为每个客户的预订生成一个唯一的 affiliate_reference_id。如果重新发送相同的请求详情（例如，由于尝试失败），应使用相同的 affiliate_reference_id 。这可以防止意外的重复预订。发送新的“创建预订”请求时，API 不会响应，直到预订被确认或拒绝。大多数响应会在几秒钟内返回。但是，少数预订可能需要几分钟的时间来处理和生成响应。
监控无法快速解决的预订
Rapid 连接到外部系统以进行实时预订。从属系统可以是不同酒店的预订系统、前台接待系统、信用卡处理机构或欺诈检测系统。98% 的预订可以在大约 13 秒内完成该过程。但是，如果您在 90 秒后未收到预订响应，请使用与预订一起发送的相同 affiliate_reference_id，通过检索请求检查预订进度。如果预订仍在进行中或预订失败，您将收到 404 错误“使用提供的请求找不到行程”。收到此消息后，您应使用相同的 affiliate_reference_id 再次尝试预订请求。如果预订仍未完成，您将看到一个 400 错误，并显示消息“具有此联盟伙伴参考 ID 的行程已存在”。如果返回此错误，您可以再次检索预订以确认预订详细信息是否可供查看。
处理预订时，检索 API 可能会返回错误或不完整的响应。稍后重试检索预订调用可解决 99.99% 的错误。如果未能解决，请与 Rapid 电话服务中心客服联系以获得进一步的支持。
预订争议
如果您遇到与超时、50x HTTP 代码错误或其他基础设施问题相关的预订问题，请提供以下 Rapid API 交易日志以进行故障排除：
- 预订请求和响应（如有）。
- 上次预订尝试 90 秒后发送的检索预订的请求和响应。
日志应包含请求和响应的 HTTP 标头。响应消息有一个 transaction-id 标头，可以帮助我们识别 Rapid API 交易。您可以通过此链接找到更多错误处理指南。
登录您的 Rapid 支持帐户即可查看用户界面示例、用于处理预订的伪代码和集成计划示例。