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