バージョニング
Flex Forward APIは長期的な安定性を重視して設計されています。既存のインテグレーションに影響を与えないよう、変更は慎重に行われます。現在のバージョン
APIのバージョンは 1.0.0 です。URLにバージョンプレフィックスはありません。すべてのエンドポイントは直接アクセスします（例：POST /labels、POST /v1/labels ではありません）。
後方互換性
Flex Forwardチームは後方互換性の維持に取り組んでいます。既存のインテグレーションはAPIの進化とともに引き続き機能します。非破壊的変更
以下の変更は事前通知なしに行われる場合があります。インテグレーションはこれらを適切に処理する必要があります：- リクエストボディへの新しいオプションフィールドの追加
- レスポンスボディへの新しいフィールドの追加
- 新しいAPIエンドポイントの追加
- レスポンスフィールドの新しいenum値の追加
- エッジケース用の新しいHTTPステータスコードの追加
- エラーメッセージの明確化
APIレスポンスで予期しないフィールドをエラーとして扱うのではなく、無視するようにしてください。未知のenum値も適切に処理してください — 例えば、認識できない追跡
tag は Unknown として扱います。これにより、非破壊的な追加に対するインテグレーションの耐性が確保されます。破壊的変更
以下の変更は破壊的と見なされ、事前に通知されます：- 既存フィールドの削除または名前変更
- 既存フィールドのデータ型の変更
- APIエンドポイントの削除
- 認証メカニズムの変更
- 既存ステータスコードの意味の変更