Endpoint REST modern, GraphQL-over-GET, dan webhook sering kali menggabungkan array bernilai banyak, objek filter bersarang, kursor Base64, serta frasa pencarian ber-encoding URL ke dalam satu query string atau body request application/x-www-form-urlencoded. Memeriksa atau mengedit payload tersebut sebagai string mentah datar sangat rentan merusak urutan escape %26 atau membuat tanda kurung tidak seimbang.
Perhatikan contoh kueri pencarian API yang menggabungkan spasi ber-encoding +, key berulang, filter kurung siku bersarang, kursor paginasi Base64 dengan padding = ber-encoding persen, dan parameter flag tanpa nilai:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Menguraikan string ini menghasilkan representasi JSON terstruktur yang langsung mudah dibaca:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Mengapa Pemisahan Pembatas Harus Mendahului Dekode Persen
Perhatikan bagaimana cursor=eyJpZCI6NDIwfQ%3D%3D didekode dengan bersih menjadi "eyJpZCI6NDIwfQ==". Parser memisahkan string mentah pada & terlebih dahulu, membagi setiap pasangan pada karakter literal = pertama, dan baru kemudian mendekode urutan + serta %XX. Jika skrip sederhana menjalankan decodeURIComponent() pada seluruh query string sebelum memisahkannya pada & dan =, nilai parameter apa pun yang mengandung ampersand ber-escape (R%26D -> R&D) akan terpecah menjadi dua parameter palsu.
Karena tampilan JSON dan tabel key-value selalu tersinkronisasi dua arah, Anda juga dapat menempelkan objek filter JSON dari kode aplikasi Anda dan langsung menyusunnya menjadi query string yang di-escape dengan benar untuk request HTTP.