feuyeux / hello-oas

Hello OAS

OAS SPEC

https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md

The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to HTTP APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

https://swagger.io/docs/specification/data-models/data-types

OpenAPI defines the following basic types:

• string (this includes dates and files)
• number
• integer
• boolean
• array
• object

Enums https://swagger.io/docs/specification/data-models/enums

Dictionaries, HashMaps and Associative Arrays https://swagger.io/docs/specification/data-models/dictionaries

oneOf, anyOf, allOf, not https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not

Inheritance and Polymorphism https://swagger.io/docs/specification/data-models/inheritance-and-polymorphism

Supported JSON Schema Keywords https://swagger.io/docs/specification/data-models/keywords

Bearer Authentication

https://swagger.io/docs/specification/authentication/bearer-authentication

OAS IMPL

https://github.com/OAI/OpenAPI-Specification/blob/main/IMPLEMENTATIONS.md

Swagger is a set of open-source tools built around the OpenAPI Specification that can help you design, build, document and consume REST APIs. The major Swagger tools include:

• Swagger Editor – browser-based editor where you can write OpenAPI specs.
• Swagger UI – renders OpenAPI specs as interactive API documentation.
• Swagger Codegen – generates server stubs and client libraries from an OpenAPI spec.

Swagger Hub

https://app.swaggerhub.com/apis/feuyeux/hello-oas/1.0.0