Migrate Beckn Core Protocol Specification from OpenAPI 3.0 to 3.1: Release core spec version 1.1.1

[rajaneeshk90]

Background

The Beckn Core Protocol is currently specified using OpenAPI version 3.0. To leverage the latest features, improvements, and compliance enhancements in OpenAPI 3.1, there is a need to update the protocol specification.

Objectives

• Upgrade Specification: Update the Beckn Core Protocol YAML files to be compliant with OpenAPI 3.1.
• Validate Compatibility: Ensure that all existing API definitions are compatible with OpenAPI 3.1 syntax and semantics.
• Documentation and Examples: Update accompanying documentation and examples to reflect changes made during the migration.
• Tooling and Integration: Verify that all related tooling (e.g., code generators, validators, linters) support and work seamlessly with OpenAPI 3.1.

Tasks

• Review Changes in OpenAPI 3.1:
  • Understand key differences between OpenAPI 3.0 and 3.1.
  • Identify features in 3.1 that are relevant to the Beckn Core Protocol.
• Update YAML Files:
  • Modify existing OpenAPI 3.0 YAML files to conform to OpenAPI 3.1 standards.
  • Ensure all endpoints, schemas, and components are correctly defined.
• Testing and Validation:
  • Use OpenAPI 3.1 validation tools to verify the updated specifications.
  • Perform integration tests to ensure no regressions or issues arise from the migration.
• Update Documentation:
  • Revise documentation to reflect changes in the specification.
  • Provide updated examples and usage guidelines for developers.
• Coordinate with Stakeholders:
  • Communicate with developers, integrators, and other stakeholders regarding the migration.
  • Offer support and guidance for any issues arising from the update.

Expected Outcomes

• A fully migrated Beckn Core Protocol specification compliant with OpenAPI 3.1.
• Updated documentation and examples that align with the new specification.
• Enhanced compatibility with modern tooling and improved protocol features.

References

• OpenAPI 3.1 Specification
• Migration Guide from OpenAPI 3.0 to 3.1

[rajaneeshk90]

PR to the version branch: #434

PR to the main branch: #439