APIが進化するにつれて、新しいメソッド、パラメータ、ロジックが登場します。現在のクライアントの作業を中断しないために、APIバージョニングが使用されます。私たちは、バージョン管理へのいくつかのアプローチをサポートしており、インテグレータは安定した運用のためのリスクなしに、目的のバージョンのインターフェイスを使用することができます。
これは、プラットフォームのスケーリングと、古いクライアントの更新、テスト、サービスの実装の両方において重要です。
バージョン管理方法
| メソッド | 説明と利点 |
|---|---|
| URLのバージョン('/v1/') | 最もわかりやすく人気のある方法は、REST APIにとって便利です |
| ヘッダーを受け入れる | 例:'Accept: application/vnd。api+json;version=2'-データをバージョンから分離 |
| GraphQLエイリアス/バージョン管理フィールド | エイリアスによる異なるバージョン:'userV1'、 'userV2'-段階的な移行に便利 |
| スキーマレベルのバージョン | バージョンごとにOpenAPI/Swaggerのダイアグラムとモジュールを分離 |
どのように実装されて
'/v1/'、 '/v2/'と独立したルートを持つAPI構造
"Accept'と"X-API-Version"ヘッダーのチェック- GraphQLはエイリアスとバージョン管理されたスキーマ('userV1'、 'userV2')をサポートしています')
- A/Bのテスト能力生産への危険なしの新しい版
- 解析と移行のための各バージョンへの呼び出しのログ
ビジネスとインテグレータのメリット
減速せずに古い顧客をサポート- マルチジェネレーションAPIパラレル動作
- 後方互換性を損なうことなく安全に新機能を実装
- インフラストラクチャの拡張とアップグレードの柔軟性
- 制御バージョンと分析バージョンのシームレスな移行
特に重要な点
複数の外部クライアントを持つプラットフォーム- APIファーストアプローチと長いライフサイクルを持つプロジェクト
- 銀行、プロバイダー、B2Bパートナーとの統合
- 長寿命のモバイルまたはIoTクライアントを持つシステム
APIバージョン管理は、統合の信頼性と柔軟性の基盤です。フォーマット(REST、 GraphQL、 gRPC)に関係なく、インターフェイスの安全な開発を保証します。
お問い合わせ
下記フォームにご記入いただければ、できるだけ早くご連絡いたします。