NOTA: Se você estiver procurando pelo Swagger Core 1.5.X e OpenAPI 2.0, consulte a ramificação 1.5.
NOTA: Desde a versão 2.1.7, o Swagger Core também oferece suporte ao namespace Jakarta. Há um conjunto paralelo de artefatos com o sufixo -jakarta
, fornecendo a mesma funcionalidade que os artefatos sem sufixo (ou seja: javax
). Por favor, consulte o Wiki para mais detalhes.
NOTA: Desde a versão 2.2.0 o Swagger Core suporta OpenAPI 3.1; veja esta página para detalhes
Swagger Core é uma implementação Java da especificação OpenAPI. A versão atual suporta JAX-RS2 (namespaces javax
e jakarta
).
Consulte o guia de introdução ao Swagger Core para começar a adicionar o Swagger à sua API.
O wiki do github contém documentação, exemplos, contribuições, etc.
A especificação OpenAPI passou por várias revisões desde a criação inicial em 2010. O projeto Swagger Core tem as seguintes compatibilidades com a especificação OpenAPI:
Versão principal do Swagger | Data de lançamento | Compatibilidade com especificações OpenAPI | Notas | Status |
---|---|---|---|---|
2.2.26 ( atualmente estável ) | 18/11/2024 | 3.x | etiqueta v2.2.26 | Suportado |
2.2.25 | 02/10/2024 | 3.x | etiqueta v2.2.25 | Suportado |
2.2.24 | 23/09/2024 | 3.x | etiqueta v2.2.24 | Suportado |
2.2.23 | 28/08/2024 | 3.x | etiqueta v2.2.23 | Suportado |
2.2.22 | 15/05/2024 | 3.x | etiqueta v2.2.22 | Suportado |
2.2.21 | 20/03/2024 | 3.x | etiqueta v2.2.21 | Suportado |
2.2.20 | 19/12/2023 | 3.x | etiqueta v2.2.20 | Suportado |
2.2.19 | 10/11/2023 | 3.x | etiqueta v2.2.19 | Suportado |
2.2.18 | 2023-10-25 | 3.x | etiqueta v2.2.18 | Suportado |
2.2.17 | 12/10/2023 | 3.x | etiqueta v2.2.17 | Suportado |
2.2.16 | 18/09/2023 | 3.x | etiqueta v2.2.16 | Suportado |
2.2.15 | 08/07/2023 | 3.x | etiqueta v2.2.15 | Suportado |
2.2.14 | 2023-06-26 | 3.x | etiqueta v2.2.14 | Suportado |
2.2.13 | 2023-06-24 | 3.x | etiqueta v2.2.13 | Suportado |
2.2.12 | 13/06/2023 | 3.x | etiqueta v2.2.12 | Suportado |
2.2.11 | 01/06/2023 | 3.x | etiqueta v2.2.11 | Suportado |
2.2.10 | 15/05/2023 | 3.x | etiqueta v2.2.10 | Suportado |
2.2.9 | 2023-03-20 | 3.x | etiqueta v2.2.9 | Suportado |
2.2.8 | 06/01/2023 | 3.x | etiqueta v2.2.8 | Suportado |
2.2.7 | 15/11/2022 | 3,0 | etiqueta v2.2.7 | Suportado |
2.2.6 | 2022-11-02 | 3,0 | etiqueta v2.2.6 | Suportado |
2.2.5 | 2022-11-02 | 3,0 | etiqueta v2.2.5 | Suportado |
2.2.4 | 16/10/2022 | 3,0 | etiqueta v2.2.4 | Suportado |
2.2.3 | 2022-09-27 | 3,0 | etiqueta v2.2.3 | Suportado |
2.2.2 | 2022-07-20 | 3,0 | etiqueta v2.2.2 | Suportado |
2.2.1 | 15/06/2022 | 3,0 | etiqueta v2.2.1 | Suportado |
2.2.0 | 04/04/2022 | 3,0 | etiqueta v2.2.0 | Suportado |
2.1.13 | 07/02/2022 | 3,0 | etiqueta v2.1.13 | Suportado |
2.1.12 | 23/12/2021 | 3,0 | etiqueta v2.1.12 | Suportado |
2.1.11 | 2021-09-29 | 3,0 | etiqueta v2.1.11 | Suportado |
2.1.10 | 2021-06-28 | 3,0 | etiqueta v2.1.10 | Suportado |
2.1.9 | 2021-04-20 | 3,0 | etiqueta v2.1.9 | Suportado |
2.1.8 | 2021-04-18 | 3,0 | etiqueta v2.1.8 | Suportado |
2.1.7 | 18/02/2021 | 3,0 | etiqueta v2.1.7 | Suportado |
2.1.6 | 04/12/2020 | 3,0 | etiqueta v2.1.6 | Suportado |
2.1.5 | 01-10-2020 | 3,0 | etiqueta v2.1.5 | Suportado |
2.1.4 | 2020-07-24 | 3,0 | etiqueta v2.1.4 | Suportado |
2.1.3 | 2020-06-27 | 3,0 | etiqueta v2.1.3 | Suportado |
2.1.2 | 01/04/2020 | 3,0 | etiqueta v2.1.2 | Suportado |
2.1.1 | 2020-01-02 | 3,0 | etiqueta v2.1.1 | Suportado |
2.1.0 | 16/11/2019 | 3,0 | etiqueta v2.1.0 | Suportado |
2.0.10 | 11/10/2019 | 3,0 | etiqueta v2.0.10 | Suportado |
2.0.9 | 22/08/2019 | 3,0 | etiqueta v2.0.9 | Suportado |
2.0.8 | 24/04/2019 | 3,0 | etiqueta v2.0.8 | Suportado |
2.0.7 | 18/02/2019 | 3,0 | etiqueta v2.0.7 | Suportado |
2.0.6 | 27/11/2018 | 3,0 | etiqueta v2.0.6 | Suportado |
2.0.5 | 19/09/2018 | 3,0 | etiqueta v2.0.5 | Suportado |
2.0.4 | 05/09/2018 | 3,0 | etiqueta v2.0.4 | Suportado |
2.0.3 | 09/08/2018 | 3,0 | etiqueta v2.0.3 | Suportado |
1.6.14 ( atualmente estável ) | 19/03/2024 | 2,0 | etiqueta v1.6.14 | Suportado |
1.6.13 | 2024-01-26 | 2,0 | etiqueta v1.6.13 | Suportado |
1.6.12 | 14/10/2023 | 2,0 | etiqueta v1.6.12 | Suportado |
1.6.11 | 15/05/2023 | 2,0 | etiqueta v1.6.11 | Suportado |
1.6.10 | 21/03/2023 | 2,0 | etiqueta v1.6.10 | Suportado |
1.6.9 | 15/11/2022 | 2,0 | etiqueta v1.6.9 | Suportado |
1.6.8 | 16/10/2022 | 2,0 | etiqueta v1.6.8 | Suportado |
1.6.7 | 2022-09-27 | 2,0 | etiqueta v1.6.7 | Suportado |
1.6.6 | 04/04/2022 | 2,0 | etiqueta v1.6.6 | Suportado |
1.6.5 | 07/02/2022 | 2,0 | etiqueta v1.6.5 | Suportado |
1.6.4 | 23/12/2021 | 2,0 | etiqueta v1.6.4 | Suportado |
1.6.3 | 2021-09-29 | 2,0 | etiqueta v1.6.3 | Suportado |
1.6.2 | 01/07/2020 | 2,0 | etiqueta v1.6.2 | Suportado |
1.6.1 | 01/04/2020 | 2,0 | etiqueta v1.6.1 | Suportado |
1.6.0 | 16/11/2019 | 2,0 | etiqueta v1.6.0 | Suportado |
1.5.24 | 11/10/2019 | 2,0 | etiqueta v1.5.24 | Suportado |
1.5.23 | 22/08/2019 | 2,0 | etiqueta v1.5.23 | Suportado |
1.5.22 | 18/02/2019 | 2,0 | etiqueta v1.5.22 | Suportado |
1.5.21 | 09/08/2018 | 2,0 | etiqueta v1.5.21 | Suportado |
1.5.20 | 23/05/2018 | 2,0 | etiqueta v1.5.20 | Suportado |
2.0.2 | 23/05/2018 | 3,0 | etiqueta v2.0.2 | Suportado |
2.0.1 | 16/04/2018 | 3,0 | etiqueta v2.0.1 | Suportado |
1.5.19 | 16/04/2018 | 2,0 | etiqueta v1.5.19 | Suportado |
2.0.0 | 20/03/2018 | 3,0 | etiqueta v2.0.0 | Suportado |
2.0.0-rc4 | 22/01/2018 | 3,0 | etiqueta v2.0.0-rc4 | Suportado |
2.0.0-rc3 | 21/11/2017 | 3,0 | etiqueta v2.0.0-rc3 | Suportado |
2.0.0-rc2 | 29/09/2017 | 3,0 | etiqueta v2.0.0-rc2 | Suportado |
2.0.0-rc1 | 17/08/2017 | 3,0 | etiqueta v2.0.0-rc1 | Suportado |
1.5.18 | 22/01/2018 | 2,0 | etiqueta v1.5.18 | Suportado |
1.5.17 | 21/11/2017 | 2,0 | etiqueta v1.5.17 | Suportado |
1.5.16 | 15/07/2017 | 2,0 | etiqueta v1.5.16 | Suportado |
1.3.12 | 23/12/2014 | 1.2 | etiqueta v1.3.12 | Suportado |
1.2.4 | 19/06/2013 | 1.1 | etiqueta swagger-project_2.10.0-1.2.4 | Obsoleto |
1.0.0 | 16/10/2011 | 1,0 | etiqueta v1.0 | Obsoleto |
Se você estiver interessado no histórico de alterações do swagger e na estrutura Swagger Core, veja aqui.
Você precisa do seguinte instalado e disponível em seu $PATH:
# first time building locally
mvn -N
Construções subsequentes:
mvn install
Isso construirá os módulos.
Claro, se você não quiser construir localmente, você pode pegar artefatos do maven central:
https://repo1.maven.org/maven2/io/swagger/core/
As amostras foram movidas para um novo repositório e contêm várias integrações e configurações.
Divulgue quaisquer problemas ou vulnerabilidades relacionadas à segurança enviando um e-mail para [email protected], em vez de usar o rastreador de problemas público.