予約可能状況のタイミングの透明性の向上
25C更新により、予約の可用性データのタイミングの可視性を高めるための新機能が追加されました。 サーバー側のタイムスタンプ・フィールドactualAtTimeが、GetBookingOptions、showBookingGridおよびfindMatchingResources API操作のレスポンスで返されるようになりました。 このフィールドは、アプリケーションがリクエストの処理を完了した正確な時間を取得し、可用性またはリソース・データが確定された時点をマークします。
この拡張は、高い同時実行性環境で特に重要です。 たとえば、予約エージェントは使用可能なスロットを取得し、1つのオープンを参照して予約を試みることができますが、その間、同じスロットに対して別の予約が処理されることがあります。 両方のアクションが同時に行われるため、これはオーバーブッキングになる可能性があります。特に、以前のレスポンスに基づいて可用性が排他的であると想定された場合です。
actualAtTimeを使用すると、顧客およびインテグレータはレスポンスが確定したタイミングをトレースできるようになり、データの生成後に矛盾する予約が発生したかどうかを理解できます。 これにより、トラフィックが高いシナリオで可用性の問題をより正確に診断できます。
予約オプションの取得、予約グリッドの表示および一致するリソースの検索API操作の変更
レスポンス変更: 実績時間
「GetBookingOptions、showBookingGridおよびfindMatchingResources」 APIファンクションのレスポンスで、パラメータactualAtTimeが追加されました。 これは、サーバー側のリクエスト処理完了のタイムスタンプです。
"actualAtTime": { "description": "UTC timestamp in format YYYY-MM-DD HH:MM:SS for which the response was calculated.", "type": "string" }
ビジネス上の利点
- 予約の不整合を自己診断し、潜在的な予約超過につながるイベントの順序を検証できます。
- サポート・チームへの依存を軽減し、解決時間を短縮し、予約システムの精度に対する信頼を高めます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。