Endpoints modernos de REST, GraphQL sobre GET e webhooks frequentemente empacotam arrays de múltiplos valores, objetos de filtro aninhados, cursores em Base64 e termos de busca codificados em URL dentro de uma única query string ou corpo de requisição application/x-www-form-urlencoded. Inspecionar ou editar esses payloads como uma string bruta plana facilita a quebra de escapes %26 e colchetes incompatíveis.
Considere uma consulta de busca de API combinando espaços em branco codificados com +, chaves repetidas, filtros de colchetes aninhados, um cursor de paginação Base64 com preenchimento = codificado percentualmente e um parâmetro de flag sem valor:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Analisar essa string produz uma representação JSON fortemente estruturada e imediatamente legível:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Por que a divisão de delimitadores deve preceder a decodificação percentual
Observe como cursor=eyJpZCI6NDIwfQ%3D%3D é decodificado de forma limpa para "eyJpZCI6NDIwfQ==". O analisador primeiro divide a string bruta em &, divide cada par no primeiro = literal e só então decodifica as sequências + e %XX. Se um script ingênuo executasse decodeURIComponent() em toda a query string antes de dividir em & e =, qualquer valor de parâmetro contendo um e comercial escapado (R%26D -> R&D) seria quebrado em dois parâmetros falsos.
Como a visualização JSON e a tabela chave-valor permanecem sincronizadas bidirecionalmente, você também pode colar um objeto de filtro JSON do código da sua aplicação e serializar imediatamente uma query string devidamente escapada e pronta para requisições HTTP.