處理預訂申請
妥善處理預訂請求，避免錯誤和損失。
簡介
設計預訂請求工作流程以容忍網路問題非常重要。不要將沒有回應解讀為預訂失敗的標誌。如果在發送預訂請求之後但在收到回覆之前出現基礎設施問題，旅客的預訂可能仍會在我們的系統中收費並確認。基礎設施問題可能是：
- 網路連線遺失 (沒有回傳回應)。
- 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的回應，請在 following-up 之前重試擷取 30 分鐘，並與我們的呼叫中心代理聯絡以獲得進一步支援。
推薦流程
一律發送 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 交易。