Lab Serialisasi Parameter OpenAPI

Pratinjau bagaimana jalur OpenAPI, kueri, header, dan parameter cookie diserialkan sesuai dengan gaya dan pengaturan ledakan, secara lokal.

Tempel atau pilih dokumen OpenAPI 3.0, 3.1 atau 3.2, periksa, pilih operasi jalur, dan sesuaikan setiap nilai parameter JSON. Pratinjau jalur, string kueri, header, dan cookie, lalu salin bagian yang Anda perlukan.

Muat dokumen OpenAPI, pilih operasi, lalu pratinjau bagaimana parameternya menjadi target permintaan, header, dan cookie. Tidak ada permintaan yang dikirim.

Tempelkan JSON atau YAML di bawah, atau pilih file.

Hingga 2 MB dan 300 jalur operasi. Mendukung OpenAPI 3.0, 3.1 dan 3.2. Referensi eksternal tidak diambil.

Cara menggunakan

Periksa bagaimana parameter API muncul di kabel

Pratinjau bagaimana jalur OpenAPI, kueri, header, dan parameter cookie diserialkan sesuai dengan gaya dan pengaturan ledakan, secara lokal.

Langkah penggunaan

  1. Masukkan sumber melalui: Spesifikasi OpenAPI.
  2. Jalankan: Periksa spesifikasi. Periksa hasil sebelum menyalin, mengunduh, atau menggunakannya di tempat lain.
  3. Atur: Operasi jalur. Gunakan referensi di bawah untuk memilih opsi yang sesuai.
  4. Jalankan: Pratinjau serialisasi. Periksa hasil sebelum menyalin, mengunduh, atau menggunakannya di tempat lain.
  5. Tempel atau pilih dokumen OpenAPI 3.0, 3.1 atau 3.2, periksa, pilih operasi jalur, dan sesuaikan setiap nilai parameter JSON. Pratinjau jalur, string kueri, header, dan cookie, lalu salin bagian yang Anda perlukan.

Memilih pengaturan

OpsiApa yang berubah
Operasi jalurIni menerapkan gaya OpenAPI dan pengaturan ledakan ke parameter jalur, kueri, header, dan cookie. Gaya umum yang didukung mencakup sederhana, label, matriks, formulir, spaceDelimited, pipeDelimited, dan deepObject.
Pratinjau serialisasiParameter berbasis konten, array atau objek bersarang, kombinasi gaya yang tidak ditentukan, dan referensi eksternal tidak dapat ditebak. Nilai header ditampilkan tanpa pengkodean URI karena aturan kutipan header bergantung pada header. Skema tidak divalidasi.

Contoh dan hasil yang diharapkan

Untuk GET /users/{id}, array kueri `tag: [api, local]` dengan `style: form` dan `explode: true` menjadi `tag=api&tag=local`. Nilai jalur skalar dikodekan sebelum dimasukkan ke dalam jalur. Alat ini tidak memvalidasi skema atau mengirim permintaan; pengkodean konten yang tidak didukung, nilai yang disarangkan, dan referensi eksternal dibiarkan untuk ditinjau secara manual.

Jika tidak berfungsi

  • Parameter berbasis konten, array atau objek bersarang, kombinasi gaya yang tidak ditentukan, dan referensi eksternal tidak dapat ditebak. Nilai header ditampilkan tanpa pengkodean URI karena aturan kutipan header bergantung pada header. Skema tidak divalidasi.
  • Tidak. Alat ini hanya membuat pratinjau lokal untuk operasi yang dipilih. Itu tidak menyelesaikan server, menambahkan otentikasi atau mengirim permintaan jaringan.
  • Jika penguraian gagal, periksa sintaks JSON atau YAML sebelum meninjau temuan API. Letakkan referensi lokal yang diperlukan di dokumen yang sama. Referensi eksternal dan skema yang tidak didukung perlu ditinjau manual; alat tidak mengambilnya atau menguji server aktif.

Apa yang diserialkan oleh alat ini?

Ini menerapkan gaya OpenAPI dan pengaturan ledakan ke parameter jalur, kueri, header, dan cookie. Gaya umum yang didukung mencakup sederhana, label, matriks, formulir, spaceDelimited, pipeDelimited, dan deepObject.

Apa yang memerlukan tinjauan manual?

Parameter berbasis konten, array atau objek bersarang, kombinasi gaya yang tidak ditentukan, dan referensi eksternal tidak dapat ditebak. Nilai header ditampilkan tanpa pengkodean URI karena aturan kutipan header bergantung pada header. Skema tidak divalidasi.

Apakah itu memanggil API?

Tidak. Alat ini hanya membuat pratinjau lokal untuk operasi yang dipilih. Itu tidak menyelesaikan server, menambahkan otentikasi atau mengirim permintaan jaringan.