Convertir objet JSON en query string

Les API, les routeurs front-end et les pipelines d’analytique stockent souvent filtres et champs de formulaire sous forme de simple carte JSON, tout en ayant encore besoin d’une chaîne de requête correctement encodée pour la barre d’adresse ou un client HTTP sortant. Cette capacité accepte un objet JSON plat, convertit chaque valeur scalaire en texte, encode en percent chaque clé et chaque valeur, et renvoie la chaîne prête à coller avec des paires ordonnées et une carte de chaînes normalisée. Les objets et tableaux imbriqués sont rejetés avec invalid_input afin que l’appelant n’émette jamais de semi-déchet qui ressemble à une URL valide.

D’un objet plat à une chaîne de requête encodée

Lorsque votre source de vérité est déjà un objet JSON —par exemple un état de filtres, un modèle de formulaire ou une carte de configuration— vous avez besoin d’un moyen déterministe de transformer cette carte au format filaire attendu par navigateurs et serveurs. Comme le chemin n’est que du travail de chaînes et d’objets, sans réseau, sans graines aléatoires et sans horloge murale, des entrées identiques produisent toujours le même JSON. Le tarif API en cas de succès est la base publiée de $0.002 par élément, et les échecs de validation ne consomment pas le solde prépayé.

Contrat d’entrée, forme de la réponse et erreurs

La valeur doit être un objet plat dont les propriétés sont des chaînes, des nombres, des booléens ou null. Les nombres non finis (NaN et Infinity) sont rejetés car ils n’ont pas de forme portable standard dans les chaînes de requête. Exemple : name Ada Lovelace, city London, active true et score quarante-deux produisent une chaîne à quatre paramètres avec espaces et caractères réservés encodés en percent. Envoyez en POST un corps JSON avec le champ obligatoire object (alias json, data, params, map, fields). Vous pouvez aussi passer object comme texte JSON qui se parse en une telle carte. Les tableaux au niveau racine, null, les scalaires et toute valeur objet ou tableau imbriquée échouent avec invalid_input et un message anglais clair nommant la mauvaise clé le cas échéant. En cas de succès la réponse inclut query (la chaîne encodée sans point d’interrogation initial), query_with_prefix (la même avec point d’interrogation, ou le seul point d’interrogation s’il n’y a pas de clés), count (le nombre de paramètres), pairs (un tableau ordonné de chaînes key et value après coercition scalaire et avant encodage) et object (une carte de chaînes last-wins de ces valeurs coercées). Échec classique : envoyer des filtres imbriqués sous une clé filter égale à un objet et recevoir invalid_input au lieu d’une URL silencieusement cassée. Le tarif API en cas de succès est la base publiée de $0.002 par élément ; les échecs de validation ne sont pas facturés.

Où la conversion JSON vers requête apporte sa valeur

Les auteurs de cursus de fondations web veulent une landing dédiée à la sérialisation objet-vers-requête plutôt que d’enterrer le sujet sous un parseur bidirectionnel, car l’intention de recherche diffère : qui tient une carte JSON veut l’encodage, pas des options de mode parse. Comme l’implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.