Съвременните REST, GraphQL-over-GET и webhook крайни точки редовно опаковат масиви с множество стойности, вложени обекти за филтриране, Base64 курсори и URL-кодирани фрази за търсене в единичен query string или тяло на заявка application/x-www-form-urlencoded. Преглеждането или редактирането на тези данни като плосък суров низ води до счупени %26 ескейпвания и несъответстващи скоби.
Разгледайте API заявка за търсене, комбинираща интервали, кодирани с +, повтарящи се ключове, вложени филтри със скоби, Base64 курсор за странициране с процентно кодирано подпълване = и самостоятелен булев параметър (флаг):
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Парсването на този низ създава незабавно четимо, строго структурирано JSON представяне:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Защо Разделянето по Разделители Трябва да Предхожда Процентното Декодиране
Забележете как cursor=eyJpZCI6NDIwfQ%3D%3D се декодира чисто до "eyJpZCI6NDIwfQ==". Парсерът първо разделя суровия низ по &, след това разделя всяка двойка при първия буквален знак = и едва тогава декодира последователностите + и %XX. Ако наивен скрипт изпълни decodeURIComponent() върху целия query string преди разделянето по & и =, всяка стойност на параметър, съдържаща ескейпнат амперсанд (R%26D -> R&D), би се разпаднала на два невалидни параметъра.
Тъй като JSON изгледът и таблицата ключ-стойност остават двупосочно синхронизирани, можете също да поставите JSON обект за филтриране от кода на вашето приложение и веднага да сериализирате правилно ескейпнат query string, готов за HTTP заявки.