Nowoczesne punkty końcowe REST, GraphQL-over-GET oraz webhooki regularnie pakują wielowartościowe tablice, zagnieżdżone obiekty filtrów, kursory Base64 i zakodowane frazy wyszukiwania w pojedynczy ciąg zapytania (query string) lub ciało żądania application/x-www-form-urlencoded. Analizowanie lub ręczne edytowanie takich ładunków jako płaskiego tekstu łatwo prowadzi do uszkodzenia sekwencji ucieczki %26 i niedopasowanych nawiasów.
Rozważmy zapytanie wyszukiwania API łączące białe znaki kodowane znakiem +, powtarzające się klucze, zagnieżdżone filtry nawiasowe, kursor paginacji Base64 z dopełnieniem = zakodowanym procentowo oraz pojedynczy parametr flagi:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Sparsowanie tego ciągu daje natychmiast czytelną, silnie ustrukturyzowaną reprezentację JSON:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Dlaczego podział na separatorach musi poprzedzać dekodowanie procentowe
Zwróć uwagę, jak cursor=eyJpZCI6NDIwfQ%3D%3D czysto dekoduje się do "eyJpZCI6NDIwfQ==". Parser najpierw dzieli surowy ciąg na znakach &, następnie rozdziela każdą parę na pierwszym dosłownym znaku =, a dopiero potem dekoduje sekwencje + oraz %XX. Gdyby naiwny skrypt uruchomił decodeURIComponent() na całym ciągu zapytania przed podziałem na & i =, każda wartość parametru zawierająca zakodowany znak ampersand (R%26D -> R&D) rozpadłaby się na dwa błędne parametry.
Ponieważ widok JSON i tabela klucz-wartość są synchronizowane dwukierunkowo, możesz również wkleić obiekt filtru JSON z kodu swojej aplikacji i natychmiast wygenerować poprawnie zakodowany ciąg zapytania gotowy do żądań HTTP.