URL parameter adalah bagian dari URL yang digunakan untuk mengirimkan data atau informasi tambahan antara client dan server. URL parameter biasanya digunakan untuk menyampaikan data dalam bentuk key dan value, yang kemudian dapat diproses oleh server untuk berbagai keperluan seperti filter konten, pencarian, atau navigasi.

Contoh format URL parameter:

https://bercharisma.com/search?query=sepatu&category=olahraga

Dalam contoh tersebut:

• query dan category adalah parameter.
• sepatu dan olahraga adalah nilai dari parameter tersebut.

URL parameter biasanya dimulai dengan tanda ? untuk menandai awal parameter, dan setiap parameter tambahan dipisahkan oleh tanda &. Pada umumnya value dari parameter tersebut adalah string.

Mengapa Parameter Berupa JSON Object

Karena kompleksitas dari sebuah operasi, menuntut sebuah API bisa lebih fleksibel terutama pada fungsi filtering atau searching kita butuh parameter yang lebih kompleks maka dari itu API harus bisa menerima parameter berupa JSON object. Adapun ketika API yang kita gunakan telah mensupport JSON object sebagai parameter, kita tidak bisa mengirimkan JSON object tersebut mentah-mentah, melainkan kita perlu mengolahnya terlebih dahulu sebelum kita kirimkan.

Aplikasi Postman

Pada aplikasi Postman (bagi teman-teman yang belum familiar bisa search dulu di google tentang aplikasi Postman), kita akan coba melakukan request dengan method GET dan parameter yang saya gunakan adalah includeFilter dan pageNumber, bisa diamati pada gambar di bawah kita menerima error code 400 alias bad request, yang membuktikan bahwa parameter tidak bisa berbentuk JSON object.

Kita perlu mengolahnya atau melakukan encode terlebih dahulu, pada Postman kita bisa menggunakan fitur EncodeURIComponent yang telah disediakan dengan cara kita block dulu value dari parameter yang diinginkan, kemudian klik kanan dan pilih EncodeURIComponent.

Nanti value nya akan berubah menjadi string seperti gambar di bawah ini dan ketika dieksekusi respon akan berubah menjadi 200 alias berhasil, bisa di lihat di respon body juga sudah bisa menampilkan data yang kita inginkan.

Ketika akan mau merubah-rubah value dari parameter tersebut, kita bisa decode dulu value tersebut dan cara nya masih sama, kita block dulu value nya kemudian klik kanan dan pilih DecodeURIComponent.

Kesimpulan

Dengan URL parameter, website atau aplikasi bisa menjadi lebih dinamis, memberikan pengalaman yang lebih baik kepada pengguna karena konten yang disajikan dapat disesuaikan dengan input yang diberikan di URL. Untuk mengirimkan JSON object sebagai parameter, kita perlu melakukan proses encoding dan decoding. Proses encoding dan decoding bisa mudah dilakukan di aplikasi Postman.

Semoga tulisan saya yang singkat ini dapat bermanfaat, sampai jumpa di kesempatan yang lainnya, terima kasih.