Современные эндпоинты REST, GraphQL-over-GET и вебхуки регулярно упаковывают массивы с несколькими значениями, вложенные объекты фильтров, курсоры в Base64 и закодированные поисковые фразы в единую строку запроса (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() для всей строки запроса до разделения по & и =, любое значение параметра с экранированным амперсандом (R%26D -> R&D) раскололось бы на два фиктивных параметра.
Поскольку представление JSON и таблица пар ключ-значение синхронизируются в обе стороны, вы также можете вставить JSON-объект фильтра из кода приложения и сразу сериализовать его в правильно экранированную строку запроса для HTTP-клиента.