處理預訂申請

妥善處理預訂請求，以避免錯誤與損失

此資訊適用於：

Rapid Lodging API
Rapid Car API
Rapid Flight 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 分鐘，若問題仍未解決，請透過 following-up 聯繫我們的客服專員以獲取進一步協助。

推薦流程

一律發送 `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 分鐘，之後再聯絡我們以獲取進一步支援。

預訂糾紛

若您在預訂過程中因超時、HTTP 50x 狀態碼錯誤或其他基礎架構問題而遇到任何困難，請提供以下交易日誌以供排除故障：

預訂申請和回應 (如有)。
在最後一次預訂嘗試後 30 分鐘發送的「檢索預訂」請求與回應。

該記錄應包含請求和回應的 HTTP 標題。回應訊息有一個 transaction-id 標題，可以協助我們識別 Rapid API 交易。

請參閱了解如何處理常見的 Rapid API 錯誤，內容包含 HTTP 錯誤回應範例、用於處理預訂的偽代碼，以及附錄中的使用者介面範例。