Penampil OpenAPI / Swagger

Render dokumen OpenAPI 3.0 / 3.1 atau Swagger 2.0 (YAML atau JSON) menjadi referensi API yang dapat dijelajahi — info, server, jalur ber-tag, parameter, contoh body permintaan yang dihasilkan dari skema, respons, dan keamanan. Perluas operasi mana pun untuk Coba dan kirim permintaan langsung dari browser Anda, atau ekspor sebagai cURL. Dokumen diurai secara lokal; target $ref jarak jauh dan skema eksternal tidak diambil (sepenuhnya lokal). Jika Anda lebih suka penyusun permintaan interaktif, lihat Klien / Penguji REST API dan seluruh keluarga Alat API.
Dokumen OpenAPI / Swagger
Coba
Parameter
Tentang penampil ini: mendukung Swagger 2.0 dan OpenAPI 3.0 / 3.1. Referensi diselesaikan di dalam dokumen saja (#/components/schemas/…, #/definitions/…); referensi berkas / URL eksternal dilaporkan dan tidak diambil. Coba panggilan tunduk pada kebijakan CORS server target — jika panggilan diblokir, gunakan Konverter cURL atau Klien REST untuk menjalankannya dari luar sandbox browser.
OpenAPI vs Swagger, v2 vs v3

Swagger adalah nama alat asli; ketika format spesifikasinya disumbangkan ke Linux Foundation pada 2015 ia menjadi OpenAPI, dan Swagger tetap hidup sebagai merek alat. Sebuah dokumen dibangun dari info (metadata), paths (operasi per endpoint), dan components (skema yang dapat digunakan ulang).

Kunci versi memberi tahu penampil parser mana yang digunakan: swagger: "2.0" versus openapi: 3.0.x — v3 memindahkan body permintaan dari parameter dan mengadopsi JSON Schema sungguhan.