mirror of
https://github.com/LukeHagar/connexion.git
synced 2025-12-10 04:19:37 +00:00
Swagger -> OpenAPI (#813)
This commit is contained in:
committed by
João Santos
parent
9bef8c46a6
commit
fc8e018a8b
@@ -7,9 +7,10 @@ Welcome to Connexion's documentation!
|
|||||||
=====================================
|
=====================================
|
||||||
|
|
||||||
Connexion is a framework on top of Flask_ that automagically handles
|
Connexion is a framework on top of Flask_ that automagically handles
|
||||||
HTTP requests based on either the `OpenAPI 2.0 Specification`_ (formerly known
|
HTTP requests defined using `OpenAPI`_ (formerly known
|
||||||
as Swagger Spec) or the `OpenAPI 3.0 Specification`_. Connexion
|
as Swagger), supporting both `v2.0`_ and `v3.0`_ of the specification.
|
||||||
allows you to write a Swagger specification and then maps the
|
|
||||||
|
Connexion allows you to write these specifications, then maps the
|
||||||
endpoints to your Python functions. This is what makes it unique from
|
endpoints to your Python functions. This is what makes it unique from
|
||||||
other tools that generate the specification based on your Python
|
other tools that generate the specification based on your Python
|
||||||
code. You are free to describe your REST API with as much detail as
|
code. You are free to describe your REST API with as much detail as
|
||||||
@@ -34,5 +35,6 @@ Contents:
|
|||||||
exceptions
|
exceptions
|
||||||
|
|
||||||
.. _Flask: http://flask.pocoo.org/
|
.. _Flask: http://flask.pocoo.org/
|
||||||
.. _OpenAPI 2.0 Specification: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
|
.. _OpenAPI: https://openapis.org/
|
||||||
.. _OpenAPI 3.0 Specification: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md
|
.. _v2.0: https://spec.openapis.org/oas/v2.0.html
|
||||||
|
.. _v3.0: https://spec.openapis.org/oas/v3.0.1.html
|
||||||
|
|||||||
Reference in New Issue
Block a user