處理預訂申請
妥善處理預訂請求，避免錯誤與損失。
簡介
設計預約請求工作流程時，務必確保其能容忍網路問題。請勿將未收到回覆視為預訂失敗的跡象。若在預訂請求發出後、但尚未收到回應前發生基礎設施問題，旅客的預訂仍可能已在我們的系統中完成收費與確認。基礎設施問題可能是：
- 網路連線中斷 (未收到回應)。
- 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% 的預訂可於約 13 秒內完成流程。但是，如果您在 90 秒後未收到預訂回應，請使用與預訂一起發送的相同 affiliate_reference_id，透過擷取請求檢查預訂進度。如果預訂仍在進行中或預訂失敗，您將收到 404 錯誤「根據提供的申請並未找到相關行程」。收到此訊息後，您應該使用相同的 affiliate_reference_id 再次嘗試預訂申請。如果預訂仍在完成中，您將看到一個 400 錯誤，其中會包含「具有此合作夥伴參考 ID 的行程已存在」的訊息。如果回傳此錯誤，您可以再次擷取預訂，以查看預訂詳情是否可供查看。
處理預訂時，擷取 API 可能會回傳錯誤或不完整的回應。稍後重試擷取預訂呼叫可恢復 99.99% 的錯誤。為應對系統降級情境，請先嘗試重新執行檢索操作 30 分鐘，若問題仍未解決，再聯繫我們尋求進一步支援。
預訂糾紛
若您在預訂過程中遭遇超時、50x HTTP 狀態碼錯誤或其他基礎設施問題，請提供以下交易記錄以利故障排除：
- 預訂申請和回應 (如有)。
- 在最後一次預約嘗試後 30 分鐘發送的「檢索預約」請求與回應。
該記錄應包含請求和回應的 HTTP 標題。回應訊息有一個 transaction-id 標題，可以協助我們識別 Rapid API 交易。