Page Comparison

...

Simple Comparison of OpenAPI Specifications

I identidy as
openapi-oran.yaml the specifications given by O-Ran Alliance revised on 31/03/2024, and
openapi.yaml the upstream openapi v3 specifications upstream in the /api folder.

Paths

openapi-oran.yaml Paths:

1. /policytypes
2. /policytypes/{policyTypeId}
3. /policytypes/{policyTypeId}/policies
4. /policytypes/{policyTypeId}/policies/{policyId}
5. /policytypes/{policyTypeId}/policies/{policyId}/status

openapi.yaml Paths:

1. /a1-policy/v2/policy-instances
2. /a1-policy/v2/policy-types
3. /a1-policy/v2/policies/{policy_id}
4. /a1-policy/v2/configuration
5. /a1-policy/v2/services/{service_id}/keepalive
6. /a1-policy/v2/services
7. /a1-policy/v2/policy-types/{policytype_id}
8. /a1-policy/v2/policies
9. /a1-policy/v2/services/{service_id}
10. /a1-policy/v2/policies/{policy_id}/status

Components

openapi-oran.yaml Components:

• Schemas:
  1. PolicyObject
  2. PolicyStatusObject
  3. PolicyTypeObject
  4. ProblemDetails
  5. JsonSchema
  6. NotificationDestination
  7. PolicyId
  8. PolicyTypeId

openapi.yaml Components:

• Schemas:
  1. policy_type_definition
  2. error_information
  3. void
  4. status_info
  5. authorization_result
  6. ric_info
  7. service_registration_info
  8. policy_info_list
  9. policy_status_info
  10. service_status
  11. ric_info_list
  12. input
  13. policy_authorization
  14. policy_type_id_list
  15. policy_info
  16. policy_id_list
  17. service_status_list
  18. service_callback_info_v2

Simple Analysis

Paths Analysis

• Both specifications provide endpoints for managing policies and policy types, but the structure and naming conventions differ.
• openapi-oran.yaml has a simpler path structure centered around policytypes and nested resources within policytypes.
• openapi.yaml includes a more complex path structure under the /a1-policy/v2 prefix, indicating versioning and a potentially more hierarchical and service-oriented approach.

Components Analysis

• openapi-oran.yaml has a focused set of schemas primarily around policies (PolicyObject, PolicyStatusObject, PolicyTypeObject) and identifiers.
• openapi.yaml has a more extensive and varied set of schemas including policy information, service registration, suggesting a broader scope.
• The schemas in openapi.yaml appear to cater to a more granular level of API operations with various status and info objects (policy_status_info, service_status, ric_info_list).

Summary

...

...

...