Moderne REST-, GraphQL-over-GET- en webhook-endpoints combineren regelmatig arrays met meerdere waarden, geneste filterobjecten, Base64-cursors en URL-gecodeerde zoektermen in één enkele querystring of application/x-www-form-urlencoded request-body. Het inspecteren of bewerken van zulke payloads als een platte ruwe string leidt al snel tot kapotte %26-escapes en niet-sluitende haken.
Neem bijvoorbeeld een API-zoekopdracht die +-gecodeerde witruimte, herhaalde keys, geneste bracketfilters, een Base64-pagineringscursor met procent-gecodeerde =-padding en een losse flag-parameter combineert:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Het parsen van deze string levert een direct leesbare, sterk gestructureerde JSON-weergave op:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Waarom Splitsen op Scheidingstekens Vóór Procent-decodering Moet Gebeuren
Merk op hoe cursor=eyJpZCI6NDIwfQ%3D%3D netjes wordt gedecodeerd naar "eyJpZCI6NDIwfQ==". De parser splitst de ruwe string eerst op &, splitst elk paar op het eerste letterlijke =-teken en decodeert pas daarna +- en %XX-reeksen. Als een naïef script decodeURIComponent() op de volledige querystring zou uitvoeren vóór het splitsen op & en =, zou elke parameterwaarde met een geëscapete ampersand (R%26D -> R&D) uiteenvallen in twee foutieve parameters.
Omdat de JSON-weergave en de key-value-tabel bidirectioneel gesynchroniseerd blijven, kun je ook een JSON-filterobject uit je applicatiecode plakken en direct een correct geëscapete querystring serialiseren die klaar is voor HTTP-requests.