Les points de terminaison modernes REST, GraphQL-over-GET et webhooks regroupent régulièrement des tableaux à valeurs multiples, des objets de filtrage imbriqués, des curseurs Base64 et des expressions de recherche encodées dans une seule query string ou un corps de requête application/x-www-form-urlencoded. Inspecter ou modifier ces charges utiles sous forme de chaîne brute plate favorise les erreurs d'échappement %26 et les crochets mal fermés.
Prenons l'exemple d'une requête de recherche API combinant des espaces encodés avec +, des clés répétées, des filtres imbriqués entre crochets, un curseur de pagination Base64 avec remplissage = encodé en pourcentage et un paramètre d'indicateur sans valeur :
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
L'analyse de cette chaîne produit une représentation JSON fortement structurée et immédiatement lisible :
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Pourquoi le découpage des délimiteurs doit précéder le décodage pourcent
Remarquez comment cursor=eyJpZCI6NDIwfQ%3D%3D est décodé proprement en "eyJpZCI6NDIwfQ==". L'analyseur découpe d'abord la chaîne brute sur &, sépare chaque paire sur le premier = littéral, et ne décode qu'ensuite les séquences + et %XX. Si un script naïf exécutait decodeURIComponent() sur l'ensemble de la query string avant de découper sur & et =, toute valeur de paramètre contenant une esperluette échappée (R%26D -> R&D) se briserait en deux paramètres erronés.
Comme la vue JSON et le tableau clé-valeur restent synchronisés de manière bidirectionnelle, vous pouvez également coller un objet de filtre JSON depuis le code de votre application et sérialiser immédiatement une query string correctement échappée, prête pour vos requêtes HTTP.