Сучасні ендпоінти 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-клієнта.