Moderne REST-, GraphQL-over-GET- und Webhook-Endpunkte verpacken regelmäßig mehrwertige Arrays, verschachtelte Filterobjekte, Base64-Cursor und URL-kodierte Suchbegriffe in einen einzigen Query-String oder application/x-www-form-urlencoded-Request-Body. Wer solche Payloads als flachen Roh-String inspiziert oder bearbeitet, riskiert schnell fehlerhafte %26-Maskierungen und nicht geschlossene Klammern.
Betrachten wir eine API-Suchanfrage, die +-kodierte Leerzeichen, wiederholte Schlüssel, verschachtelte Klammerfilter, einen Base64-Paginierungs-Cursor mit prozentkodiertem =-Padding und einen einzelnen Flag-Parameter kombiniert:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Das Parsen dieses Strings erzeugt eine sofort lesbare, klar strukturierte JSON-Darstellung:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Warum das Aufteilen an Trennzeichen vor der Prozent-Dekodierung erfolgen muss
Beachten Sie, wie cursor=eyJpZCI6NDIwfQ%3D%3D sauber zu "eyJpZCI6NDIwfQ==" dekodiert wird. Der Parser teilt den Roh-String zuerst an & auf, trennt jedes Paar am ersten literalen = und dekodiert erst danach +- und %XX-Sequenzen. Würde ein naives Skript decodeURIComponent() über den gesamten Query-String ausführen, bevor an & und = getrennt wird, würde jeder Parameterwert mit einem maskierten Kaufmanns-Und (R%26D -> R&D) in zwei fehlerhafte Einzelparameter zerbrechen.
Da die JSON-Ansicht und die Key-Value-Tabelle bidirektional synchronisiert bleiben, können Sie auch ein JSON-Filterobjekt aus Ihrem Anwendungscode einfügen und sofort einen korrekt maskierten Query-String für HTTP-Requests serialisieren.