API バージョニング

よくある形式の API バージョニング。同じプロフィールが 2 つの形で返ります。v1（非推奨：フラットなフィールド。Deprecation / Sunset / Link successor-version ヘッダーを送る）と v2（ネスト）。バージョンは URL パス（/api/v1、/api/v2）で、または /api/versioned/profile で X-API-Version ヘッダー、?api-version= クエリ、Accept: application/vnd.apibee.v2+json（この順に確認）で選びます。よくある形式の API バージョニング。同じプロフィールが 2 つの形で返ります。v1（非推奨：フラットなフィールド。Deprecation / Sunset / Link successor-version ヘッダーを送る）と v2（ネスト）。バージョンは URL パス（… … で X-API-Version ヘッダー、?api-version= クエリ、Accept: application/vnd.apibee.v2+json（この順に確認）で選びます。

• GEThttps://api.testingapis.com/api/v1/profileGet the profile in the deprecated v1 shapeGet the profile in the deprecated v1 shape (selected by URL path).
• GEThttps://api.testingapis.com/api/v2/profileGet the profile in the current v2 shapeGet the profile in the current v2 shape (selected by URL path).
• GEThttps://api.testingapis.com/api/versioned/profileGet the profile in the version chosen by header, query string or media typeGet the profile in the version chosen by header, query string or media type.
• GEThttps://api.testingapis.com/api/versionsList supported API versions and how to select themList supported API versions and how to select them.

curl -X GET "https://api.testingapis.com/api/v1/profile"

{
  "id": 101,
  "name": "Ava Thompson",
  "email": "ava.thompson@example.com",
  "phone": "+1-555-0101",
  "address": "742 Evergreen Terrace, Springfield, IL 62704, USA",
  "memberSince": "2023-04-12"
}