Tidak suka iklan? Pergi Bebas Iklan Hari ini 

Pengubah OpenAPI v2 ke v3

DataPengembang

IKLAN · HAPUS?

MEMASUKKAN

Proses Otomatis

KELUARAN

Sisi klien

IKLAN · HAPUS?

Memandu

Pengubah OpenAPI v2 ke v3

Tempel spesifikasi Swagger 2.0 dan dapatkan versi OpenAPI 3.0.3 yang valid kembali dalam format JSON atau YAML. Konverter menerapkan aturan peta struktural resmi — memindahkan definitions di bawah components/schemas, menggabungkan host, basePathdan schemes ke dalam servers, membagi consumes dan produces ke dalam peta per-operasi content dan menyesuaikan parameter form serta definisi keamanan — sehingga spesifikasi Anda bekerja dengan alat OpenAPI modern.

Cara Penggunaan

Tempel spesifikasi Swagger 2.0 Anda ke kotak masukan. JSON dan YAML diterima; format secara otomatis dideteksi.
Pilih format keluaran: pertahankan format masukan, atau paksa ke JSON atau YAML.
Biarkan Memperbaiki field yang hilang untuk mengisi secara otomatis field wajib v3 seperti info.title, info.version, dan deskripsi respons yang hilang saat sumber v2 mengabaikannya.
Baca ringkasan konversi dan peringatan yang ditampilkan di atas hasil, lalu salin atau unduh spesifikasi OpenAPI 3.0.3 yang dihasilkan.

Fitur

Masuk JSON dan YAML, keluar JSON atau YAML — pilih format yang Anda inginkan, atau salin format masukan.
Peta struktural — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses dipindahkan ke bawah components, dan setiap $ref penunjuk diubah agar sesuai.
Pelayanan dari host, basePath, schemes — digabungkan ke dalam array v3 servers dengan HTTPS yang diprioritaskan ketika lebih dari satu skema disebutkan.
Negosiasi konten — consumes dan produces diterjemahkan ke dalam peta per-operasi requestBody.content dan responses[*].content .
Parameter dan parameter form — in: body menjadi field v3 requestBodydan in: formData field dikelompokkan ke dalam multipart/form-data atau application/x-www-form-urlencoded skema badan permintaan.
Peningkatan alur keamanan — nilai OAuth2 flow dipindahkan ke objek v3 flows ()implicit, password, clientCredentials, authorizationCode).
Mode perbaikan — ketika diaktifkan, mengisi field yang hilang sehingga output lolos validator v3 alih-alih gagal karena kekurangan kecil pada sumber.
Ringkasan konversi & peringatan — jumlah jalur, skema, dan alur keamanan yang dikonversi, ditambah peringatan untuk apa pun yang tidak dapat dipetakan secara satu-satu.
Berjalan sepenuhnya di browser Anda — spesifikasi Anda tidak pernah keluar dari halaman.

 Tanya Jawab Umum

Apa yang berubah secara struktural antara Swagger 2.0 dan OpenAPI 3.0?

OpenAPI 3.0 mengorganisasi bagian yang dapat digunakan secara bersama di bawah satu components objek: definitions menjadi components/schemas, parameters menjadi components/parameters, responses menjadi components/responsesdan securityDefinitions menjadi components/securitySchemes. Permukaan transportasi juga berubah: host, basePathdan schemes digabungkan ke dalam array dari URL dasar lengkap, sementara array implisit servers diganti dengan peta eksplisit consumes dan produces yang diatur berdasarkan tipe media pada setiap badan permintaan dan respons. content Mengapa badan permintaan membutuhkan bentuk baru di OpenAPI 3.0?
Di Swagger 2.0, badan permintaan hanya merupakan parameter lain dengan

, dan parameter form adalah parameter dengan in: body. Hal ini menggabungkan dua kepedulian berbeda (parameter jalur/parameter query/parameter header versus beban permintaan) ke dalam satu daftar dan membuat negosiasi konten menjadi tidak nyaman. OpenAPI 3.0 memisahkan keduanya: parameter hanya digunakan untuk jalur, query, header, dan cookie; beban permintaan pindah ke objek tingkat atas in: formData. Ini memungkinkan Anda menggambarkan satu endpoint yang menerima requestBody dengan content dengan skema yang berbeda untuk setiap. application/json, multipart/form-datadan application/x-www-form-urlencoded Apakah Swagger 2.0 dan OpenAPI 3.0 kompatibel secara koneksi?
Tidak. Mereka adalah versi format deskripsi, bukan versi protokol API, sehingga spesifikasi yang dikonversi tidak mengubah cara layanan Anda merespons secara real-time — tetapi alat (generator, validator, server simulasi, viewer UI) harus memahami versi yang Anda publikasikan. OpenAPI 3.0 memperkenalkan fitur yang tidak memiliki ekuivalen di versi 2, termasuk

, callback, link, dan alur keamanan yang lebih kaya. Pergeseran ke depan (v3 → v2) secara umum kehilangan informasi, sementara perpindahan ke belakang (v2 → v3) secara umum bersifat mekanis karena v2 merupakan subset ketat dari ekspresivitas v3. oneOf/anyOf/notApa arti
dalam konteks ini? $ref adalah penunjuk JSON seperti

A $ref . Konversi harus mengubah setiap penunjuk karena jalur tujuannya berubah: #/definitions/User, dan seterusnya. Penunjuk itu sendiri tidak di-resolusi (dokumen masih merujuk ke lokasi), tetapi harus diubah secara sinkron dengan perpindahan struktural agar spesifikasi v3 yang dihasilkan tetap konsisten secara internal. #/definitions/User menjadi #/components/schemas/User, #/parameters/AuthHeader menjadi #/components/parameters/AuthHeaderTempel spesifikasi Swagger 2.0 Anda di sini (YAML atau JSON)...