import json

from metadata.sdk import configure
from metadata.sdk.entities import APICollections

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# List all versions
versions = APICollections.get_versions("0f7ee81c-8163-4097-8adb-45c3d6c7b14b")
for v in versions:
    version = json.loads(v)
    print(f"Version {version['version']}: {version.get('description')}")

# Get a specific version
ac_v1 = APICollections.get_specific_version(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    "0.1"
)
print(f"Original description: {ac_v1.description.root if ac_v1.description else None}")

import org.openmetadata.schema.entity.data.APICollection;
import org.openmetadata.schema.type.EntityHistory;

// client is an initialized OpenMetadataClient.

// List all versions
EntityHistory history = client.apiCollections().getVersionList("0f7ee81c-8163-4097-8adb-45c3d6c7b14b");

System.out.println("Total versions: " + history.getVersions().size());

// Get a specific version
APICollection v1 = client.apiCollections().getVersion(
    "0f7ee81c-8163-4097-8adb-45c3d6c7b14b",
    0.1
);
System.out.println("Description: " + v1.getDescription());

# List all versions
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b/versions" \
  -H "Authorization: Bearer {access_token}"

# Get a specific version
curl "{base_url}/api/v1/apiCollections/0f7ee81c-8163-4097-8adb-45c3d6c7b14b/versions/0.1" \
  -H "Authorization: Bearer {access_token}"

{
  "entityType": "apiCollection",
  "versions": [
    "{\"id\":\"0f7ee81c-8163-4097-8adb-45c3d6c7b14b\",\"name\":\"pet\",\"fullyQualifiedName\":\"sample_api_service.pet\",\"version\":0.2,\"description\":\"Updated: Pet-related API endpoints\",\"serviceType\":\"Rest\"}",
    "{\"id\":\"0f7ee81c-8163-4097-8adb-45c3d6c7b14b\",\"name\":\"pet\",\"fullyQualifiedName\":\"sample_api_service.pet\",\"version\":0.1,\"serviceType\":\"Rest\"}"
  ]
}