VALUE AND LIMITATIONS
共通化できる範囲と、残る差分
全業界を一つの巨大スキーマに統一せず、横断共通層・カテゴリ別層・固有拡張を分離します。
三層構造
第1層：全業界共通認証 / request_id / Idempotency-Key / 共通エラー / メータリング / 請求・精算 / 監査
第2層：カテゴリ別共通仕様宿泊の価格・在庫、交通の位置・リアルタイム性、物流の重量・追跡状態などを業界別に定義
第3層：提供企業固有拡張会員限定プラン、独自車両、再配達枠などはextensionsで保持
個別接続と共通PFの比較
| 項目 | 個別接続 | 共通PF | 残る論点 |
|---|---|---|---|
| 仕様書 | 提供企業ごとに確認 | カテゴリ共通仕様を確認 | 固有拡張は別途理解が必要 |
| 認証 | 各社APIキー・OAuth等 | PF共通APIキー | 本番では企業SSO・OAuthを再設計 |
| リクエスト・レスポンス | 各社別 | 同一カテゴリで共通 | 業務意味と単位の定義が重要 |
| エラー | 各社別コード・形式 | 共通エラーEnvelope | 業務エラーの意味はカテゴリ別 |
| 提供企業切替 | コード・テスト改修 | provider指定・選択ルール変更 | 品質・契約差により完全無改修ではない |
| ログ・費用 | 各社別 | 一元表示 | PF計測の正確性と責任が増える |
成功と失敗を同等に扱う
正常応答だけでは、共通仕様の実務価値と運営負荷を評価できません。
障害
遅延、タイムアウト、429、提供側停止
不適合
必須項目欠損、型不正、バージョン不一致
取引制御
冪等性、部分成功、保証枠超過
運営責任
公開停止、品質監視、課金判定、監査