Skip to main content

Parameter Umum

tip

Mengisi parameter adalah salah satu pekerjaan yang paling merepotkan bagi kami, terutama untuk banyak API yang sering memiliki banyak parameter dengan nama dan makna yang sama. Jika harus memasukkannya secara manual setiap kali, akan sangat memakan waktu dan tidak efisien. Kami bisa menyelesaikan masalah ini melalui Parameter Umum.
Catatan: Sejak versi 2.0.22, Parameter Umum telah ditingkatkan menjadi Kamus Data (Data Dictionary), yang mendukung pengelolaan terpadu dan standar untuk bidang seperti tipe parameter, nilai default, dan deskripsi parameter. Kamu juga bisa dengan cepat memilih dan menggunakannya saat pengisian.

image.png

Cara Menggunakan Kamus Data

Kita dapat mengisi sebelumnya deskripsi parameter umum, nilai default, tipe, nilai contoh, nilai enumerasi, dan informasi lainnya di Kamus Data, yang mendukung impor cepat dengan format key-value, raw-json, dan MysqlDDL.

//key-value, Format: Key:Description
role: Peran pengguna
name: Nama pengguna
age: Usia pengguna

//raw-json, Format: {"Key":"Description"}
{"role": "Peran pengguna",
"name": "Nama pengguna",
"age": "Usia pengguna"}

image.png

Dimanapun kamu perlu memasukkan nama parameter, kamu dapat dengan cepat memilih dari dropdown. Mendukung pencarian berdasarkan kata kunci atau nama catatan langsung di kotak input. Setelah memilih parameter, nilai dan deskripsi parameter yang sudah didefinisikan sebelumnya akan terisi otomatis, sehingga tidak perlu lagi mengisi secara manual.

image.png

Selain itu, kami juga menyediakan sekumpulan parameter umum bawaan dalam sistem, yang dapat kamu aktifkan hanya dengan menggeser tombol.

image.png

Cara Memelihara

Untuk meningkatkan efisiensi pengembangan, kami menyediakan tiga cara untuk memelihara kamus data.

Menambahkan Entri Kamus Data Baru

Klik "Tambah Baru" di halaman kamus data untuk menambahkan entri parameter umum dalam jendela popup.
Catatan: Jika nama parameter duplikat, kamu dapat menggunakan nama catatan untuk membedakannya, dan kamu juga dapat mencari dengan nama catatan.

image.png

image.png

Ekstraksi Deskripsi Otomatis

Saat mendesain atau debugging API, semua deskripsi parameter yang kamu isi akan otomatis diekstrak ke dalam kamus data dan disimpan dalam status sementara.

Data yang disimpan sementara akan hilang saat memuat ulang halaman. Kamu harus mengklik simpan agar menjadi permanen.

image.png

image.png

Saat parameter baru yang kamu masukkan tidak ada di kamus data, tombol Simpan Parameter akan muncul untuk menyimpannya dengan cepat.

image.png

Impor Data

Dukungan impor cepat lewat format key-value, raw-json, dan MysqlDDL:

//key-value, Format: Key:Description
role: Peran pengguna
name: Nama pengguna
age: Usia pengguna

//raw-json, Format: {"Key":"Description"}
{"role": "Peran pengguna",
"name": "Nama pengguna",
"age": "Usia pengguna"}

image.png