API Versioning - CI/CD用語集の定義
API versioning は複数の API バージョンを公開し、producer が既存の consumer を壊さずに進化できるようにします。
API versioning は API の異なるバージョンを(URLパス、header、query 経由で)公開する手法で、既存のクライアントを壊さずに変更を出荷できるようにします。CIは古いバージョンがドキュメント通りに応答し続けるかを検証することがよくあります。
versioning の戦略には /v2 のような URL プレフィックス、header、media type があります。どれを選んでも、CIは古いバージョンの contract test を実行して、それが安定したままであることを保証できます。
関連ガイド
Semantic API Versioning - CI/CD Glossary DefinitionSemantic API Versioning: Semantic API versioning applies semantic versioning (MAJOR.MINOR.PATCH) to an API, w…
Backward Compatibility - CI/CD Glossary DefinitionBackward Compatibility: Backward compatibility means a newer version of an API still works with clients built…
Breaking Change Detection - CI/CD Glossary DefinitionBreaking Change Detection: Breaking change detection compares two versions of an API schema or contract and f…