หมายเหตุ: หากคุณกำลังมองหา Swagger Core 1.5.X และ OpenAPI 2.0 โปรดดูที่สาขา 1.5
หมายเหตุ: ตั้งแต่เวอร์ชัน 2.1.7 Swagger Core ยังรองรับเนมสเปซจาการ์ตาด้วย มีชุดอาร์ติแฟกต์คู่ขนานที่มีส่วนต่อท้าย -jakarta
ซึ่งมีฟังก์ชันการทำงานเหมือนกับอาร์ติแฟกต์ที่ไม่มีส่วนต่อท้าย (เช่น: javax
) โปรดดูวิกิสำหรับรายละเอียดเพิ่มเติม
หมายเหตุ: เนื่องจากเวอร์ชัน 2.2.0 Swagger Core รองรับ OpenAPI 3.1; ดูหน้านี้เพื่อดูรายละเอียด
Swagger Core เป็นการใช้งาน Java ของข้อกำหนด OpenAPI เวอร์ชันปัจจุบันรองรับ JAX-RS2 (เนมสเปซ javax
และ jakarta
)
ดูคำแนะนำในการเริ่มต้นใช้งาน Swagger Core เพื่อเริ่มต้นการเพิ่ม Swagger ลงใน API ของคุณ
วิกิ GitHub ประกอบด้วยเอกสาร ตัวอย่าง การสนับสนุน ฯลฯ เริ่มต้นที่นั่น
ข้อมูลจำเพาะของ OpenAPI ได้รับการแก้ไขหลายครั้งนับตั้งแต่การสร้างครั้งแรกในปี 2010 โปรเจ็กต์ Swagger Core มีความเข้ากันได้กับข้อกำหนด OpenAPI ดังต่อไปนี้:
เวอร์ชันหลักสแวกเกอร์ | วันที่วางจำหน่าย | ความเข้ากันได้ของข้อกำหนด OpenAPI | หมายเหตุ | สถานะ |
---|---|---|---|---|
2.2.26 ( ปัจจุบันมีเสถียรภาพ ) | 18-11-2024 | 3.x | แท็ก v2.2.26 | รองรับ |
2.2.25 | 02-10-2024 | 3.x | แท็ก v2.2.25 | รองรับ |
2.2.24 | 23-09-2024 | 3.x | แท็ก v2.2.24 | รองรับ |
2.2.23 | 28-08-2024 | 3.x | แท็ก v2.2.23 | รองรับ |
2.2.22 | 15-05-2024 | 3.x | แท็ก v2.2.22 | รองรับ |
2.2.21 | 2024-03-20 | 3.x | แท็ก v2.2.21 | รองรับ |
2.2.20 | 19-12-2566 | 3.x | แท็ก v2.2.20 | รองรับ |
2.2.19 | 10-11-2566 | 3.x | แท็ก v2.2.19 | รองรับ |
2.2.18 | 25-10-2566 | 3.x | แท็ก v2.2.18 | รองรับ |
2.2.17 | 12-10-2566 | 3.x | แท็ก v2.2.17 | รองรับ |
2.2.16 | 18-09-2023 | 3.x | แท็ก v2.2.16 | รองรับ |
2.2.15 | 08-07-2023 | 3.x | แท็ก v2.2.15 | รองรับ |
2.2.14 | 26-06-2023 | 3.x | แท็ก v2.2.14 | รองรับ |
2.2.13 | 24-06-2023 | 3.x | แท็ก v2.2.13 | รองรับ |
2.2.12 | 13-06-2023 | 3.x | แท็ก v2.2.12 | รองรับ |
2.2.11 | 01-06-2023 | 3.x | แท็ก v2.2.11 | รองรับ |
2.2.10 | 15-05-2023 | 3.x | แท็ก v2.2.10 | รองรับ |
2.2.9 | 2023-03-20 | 3.x | แท็ก v2.2.9 | รองรับ |
2.2.8 | 06-01-2023 | 3.x | แท็ก v2.2.8 | รองรับ |
2.2.7 | 15-11-2565 | 3.0 | แท็ก v2.2.7 | รองรับ |
2.2.6 | 02-11-2022 | 3.0 | แท็ก v2.2.6 | รองรับ |
2.2.5 | 02-11-2022 | 3.0 | แท็ก v2.2.5 | รองรับ |
2.2.4 | 16-10-2565 | 3.0 | แท็ก v2.2.4 | รองรับ |
2.2.3 | 27-09-2022 | 3.0 | แท็ก v2.2.3 | รองรับ |
2.2.2 | 2022-07-20 | 3.0 | แท็ก v2.2.2 | รองรับ |
2.2.1 | 15-06-2022 | 3.0 | แท็ก v2.2.1 | รองรับ |
2.2.0 | 04-04-2022 | 3.0 | แท็ก v2.2.0 | รองรับ |
2.1.13 | 07-02-2022 | 3.0 | แท็ก v2.1.13 | รองรับ |
2.1.12 | 23-12-2021 | 3.0 | แท็ก v2.1.12 | รองรับ |
2.1.11 | 29-09-2021 | 3.0 | แท็ก v2.1.11 | รองรับ |
2.1.10 | 28-06-2021 | 3.0 | แท็ก v2.1.10 | รองรับ |
2.1.9 | 2021-04-20 | 3.0 | แท็ก v2.1.9 | รองรับ |
2.1.8 | 18-04-2021 | 3.0 | แท็ก v2.1.8 | รองรับ |
2.1.7 | 18-02-2021 | 3.0 | แท็ก v2.1.7 | รองรับ |
2.1.6 | 2020-12-04 | 3.0 | แท็ก v2.1.6 | รองรับ |
2.1.5 | 2020-10-01 | 3.0 | แท็ก v2.1.5 | รองรับ |
2.1.4 | 2020-07-24 | 3.0 | แท็ก v2.1.4 | รองรับ |
2.1.3 | 2020-06-27 | 3.0 | แท็ก v2.1.3 | รองรับ |
2.1.2 | 2020-04-01 | 3.0 | แท็ก v2.1.2 | รองรับ |
2.1.1 | 2020-01-02 | 3.0 | แท็ก v2.1.1 | รองรับ |
2.1.0 | 16-11-2019 | 3.0 | แท็ก v2.1.0 | รองรับ |
2.0.10 | 11-10-2019 | 3.0 | แท็ก v2.0.10 | รองรับ |
2.0.9 | 2019-08-22 | 3.0 | แท็ก v2.0.9 | รองรับ |
2.0.8 | 2019-04-24 | 3.0 | แท็ก v2.0.8 | รองรับ |
2.0.7 | 2019-02-18 | 3.0 | แท็ก v2.0.7 | รองรับ |
2.0.6 | 27-11-2018 | 3.0 | แท็ก v2.0.6 | รองรับ |
2.0.5 | 2018-09-19 | 3.0 | แท็ก v2.0.5 | รองรับ |
2.0.4 | 2018-09-05 | 3.0 | แท็ก v2.0.4 | รองรับ |
2.0.3 | 2018-08-09 | 3.0 | แท็ก v2.0.3 | รองรับ |
1.6.14 ( ปัจจุบันมีเสถียรภาพ ) | 19-03-2024 | 2.0 | แท็ก v1.6.14 | รองรับ |
1.6.13 | 26-01-2024 | 2.0 | แท็ก v1.6.13 | รองรับ |
1.6.12 | 14-10-2566 | 2.0 | แท็ก v1.6.12 | รองรับ |
1.6.11 | 15-05-2023 | 2.0 | แท็ก v1.6.11 | รองรับ |
1.6.10 | 21-03-2023 | 2.0 | แท็ก v1.6.10 | รองรับ |
1.6.9 | 15-11-2565 | 2.0 | แท็ก v1.6.9 | รองรับ |
1.6.8 | 16-10-2565 | 2.0 | แท็ก v1.6.8 | รองรับ |
1.6.7 | 27-09-2022 | 2.0 | แท็ก v1.6.7 | รองรับ |
1.6.6 | 04-04-2022 | 2.0 | แท็ก v1.6.6 | รองรับ |
1.6.5 | 07-02-2022 | 2.0 | แท็ก v1.6.5 | รองรับ |
1.6.4 | 23-12-2021 | 2.0 | แท็ก v1.6.4 | รองรับ |
1.6.3 | 29-09-2021 | 2.0 | แท็ก v1.6.3 | รองรับ |
1.6.2 | 2020-07-01 | 2.0 | แท็ก v1.6.2 | รองรับ |
1.6.1 | 2020-04-01 | 2.0 | แท็ก v1.6.1 | รองรับ |
1.6.0 | 16-11-2019 | 2.0 | แท็ก v1.6.0 | รองรับ |
1.5.24 | 11-10-2019 | 2.0 | แท็ก v1.5.24 | รองรับ |
1.5.23 | 2019-08-22 | 2.0 | แท็ก v1.5.23 | รองรับ |
1.5.22 | 2019-02-18 | 2.0 | แท็ก v1.5.22 | รองรับ |
1.5.21 | 2018-08-09 | 2.0 | แท็ก v1.5.21 | รองรับ |
1.5.20 | 23-05-2018 | 2.0 | แท็ก v1.5.20 | รองรับ |
2.0.2 | 23-05-2018 | 3.0 | แท็ก v2.0.2 | รองรับ |
2.0.1 | 2018-04-16 | 3.0 | แท็ก v2.0.1 | รองรับ |
1.5.19 | 2018-04-16 | 2.0 | แท็ก v1.5.19 | รองรับ |
2.0.0 | 2018-03-20 | 3.0 | แท็ก v2.0.0 | รองรับ |
2.0.0-rc4 | 2018-01-22 | 3.0 | แท็ก v2.0.0-rc4 | รองรับ |
2.0.0-rc3 | 21-11-2017 | 3.0 | แท็ก v2.0.0-rc3 | รองรับ |
2.0.0-rc2 | 29-09-2017 | 3.0 | แท็ก v2.0.0-rc2 | รองรับ |
2.0.0-rc1 | 17-08-2017 | 3.0 | แท็ก v2.0.0-rc1 | รองรับ |
1.5.18 | 2018-01-22 | 2.0 | แท็ก v1.5.18 | รองรับ |
1.5.17 | 21-11-2017 | 2.0 | แท็ก v1.5.17 | รองรับ |
1.5.16 | 15-07-2017 | 2.0 | แท็ก v1.5.16 | รองรับ |
1.3.12 | 23-12-2557 | 1.2 | แท็ก v1.3.12 | รองรับ |
1.2.4 | 19-06-2013 | 1.1 | แท็กผยอง-project_2.10.0-1.2.4 | เลิกใช้แล้ว |
1.0.0 | 16-10-2554 | 1.0 | แท็ก v1.0 | เลิกใช้แล้ว |
หากคุณสนใจประวัติการเปลี่ยนแปลงของ Swagger และเฟรมเวิร์ก Swagger Core โปรดดูที่นี่
คุณต้องติดตั้งและพร้อมใช้งานสิ่งต่อไปนี้ใน $PATH ของคุณ:
# first time building locally
mvn -N
งานสร้างครั้งต่อไป:
mvn install
สิ่งนี้จะสร้างโมดูล
แน่นอน หากคุณไม่ต้องการสร้างในเครื่อง คุณสามารถคว้าสิ่งประดิษฐ์จาก Maven Central:
https://repo1.maven.org/maven2/io/swagger/core/
ตัวอย่างได้ย้ายไปยังพื้นที่เก็บข้อมูลใหม่และมีการผสานรวมและการกำหนดค่าต่างๆ
โปรดเปิดเผยปัญหาหรือช่องโหว่ด้านความปลอดภัยโดยส่งอีเมลไปที่ [email protected] แทนที่จะใช้เครื่องมือติดตามปัญหาสาธารณะ