gin-swagger icon indicating copy to clipboard operation
gin-swagger copied to clipboard

Update to OpenAPI 3.0 Specification

Open LuizWeitz opened this issue 8 months ago • 2 comments

Update to OpenAPI 3.0 Specification

Description

The API documentation needs to be updated to use the latest OpenAPI Specification 3.0. The new version introduces several improvements, including better support for JSON Schema, improved security definitions, and enhanced reusability of components.

For more details on OpenAPI 3.0, refer to the official specification: [OpenAPI 3.0 Specification](https://swagger.io/specification/).

Expected Changes

  • Update the OpenAPI version in the documentation
  • Adjust schema definitions to align with OpenAPI 3.0
  • Improve validation and structure based on the latest standards

Why this update?

  • Ensures compliance with the latest API documentation standards
  • Provides better tooling support and compatibility
  • Enhances clarity and maintainability of the API schema

Additional Context

Please assess the impact of this update on existing clients and integrations before implementing the changes.

LuizWeitz avatar Mar 26 '25 20:03 LuizWeitz

I need it (OpenAPI 3.0) too. please dev it. thank you.

yyle88 avatar Mar 30 '25 09:03 yyle88

This would be super useful, as it will keep the tool alive in the future and inline the open api spec 🙂

apgmckay avatar Apr 14 '25 08:04 apgmckay