Convertire oggetto JSON in query string
Costruisca la parte finale di un indirizzo web con i suoi valori senza romperlo: un nome, una città, un indicatore sì o no e un punteggio diventano 4 parametri, e Ada Lovelace viaggia sicuro come Ada%20Lovelace. Riceve il risultato con e senza punto interrogativo. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Funziona nel tuo browser: gratis, senza registrazione, i file non escono dal tuo dispositivo.
Unire a mano ampersand e segni di uguale fallisce non appena un valore contiene uno spazio, un ampersand, una lettera non ASCII o un carattere riservato.
Da un oggetto piatto a una query string codificata
Una query string URL è una sequenza di campi nome-uguale-valore uniti da ampersand, opzionalmente preceduta da un punto interrogativo dopo il percorso. Questa capacità percorre le chiavi proprie dell’oggetto in ordine di inserimento, converte ogni valore scalare in una stringa stabile (i booleani diventano true o false, i numeri finiti usano la notazione decimale ordinaria, null diventa un valore vuoto) e applica encodeURIComponent a ogni chiave e ogni valore così gli spazi diventano percent-twenty, gli ampersand percent-twenty-six e Unicode sopravvive al transito.
Il risultato è una query string senza inventare separatori extra da caratteri speciali grezzi. Oggetti e array annidati non sono supportati di proposito: un parametro di query è una coppia chiave-valore piatta, e serializzare struttura annidata in un’unica stringa opaca nasconderebbe errori che il chiamante di solito vuole correggere prima che la richiesta lasci il client. Gli oggetti vuoti producono una query string vuota e la forma con solo il prefisso a punto interrogativo, utile per i test che affermano l’assenza di parametri invece di inventare una chiave fittizia.
Limiti di lunghezza sul numero di chiavi e sulla dimensione totale serializzata impediscono a mappe patologiche di esaurire la memoria sul percorso gratuito del browser.
Quando conviene trasformare i valori in parametri
Le app front-end che tengono chip di filtro e paginazione come un oggetto semplice necessitano di un unico codificatore prima di scrivere location.search così un testo dall’aspetto multi-valore non si spezza mai su un ampersand grezzo. I servizi backend che registrano richieste in uscita o costruiscono URL firmati da mappe di configurazione necessitano delle stesse regole di codifica percent del browser affinché ticket di supporto e log di accesso corrispondano a ciò che il client ha davvero inviato. La validazione fallita non consuma saldo.
Mantenga le mappe piatte e entro i limiti documentati, fissi la query codificata nei test e otterrà stringhe di parametri riproducibili per dashboard, plugin LMS e worker di edge senza montare un kit URL completo per conto Suo.
Casi d'uso
Costruire location.search dallo stato dell’app
Trasformi un oggetto piatto di filtri o form in una query string codificata in percent prima di scrivere la barra degli indirizzi o la voce di cronologia del browser.
Domande frequenti
Quali tipi di valore sono ammessi?
Stringhe, numeri finiti, booleani e null. Null diventa un valore vuoto dopo il segno di uguale.
Chiavi e valori sono codificati in percent?
Sì. Chiavi e valori sono codificati con encodeURIComponent così spazi, ampersand, segni di uguale e caratteri non ASCII non inventano parametri extra.
Che fine fa uno spazio o una e commerciale dentro un valore?
Viene codificato perché non possa spezzare l'indirizzo nel punto sbagliato. Uno spazio diventa %20, come in Ada%20Lovelace, e la e commerciale, le lettere accentate e gli altri caratteri riservati vengono codificati allo stesso modo, come fa il browser.
Posso convertire dati annidati o liste?
No. È accettato solo un insieme piatto di nomi e valori. Una sezione annidata o una lista vengono rifiutate con un messaggio chiaro, così non si ritrova mai con un indirizzo che sembra valido ma porta dati strutturati a metà.
Cosa succede a un valore vuoto?
Un valore vuoto diventa un parametro con il suo nome e niente dopo il segno di uguale, quindi il nome viene comunque inviato. Un insieme vuoto dà un risultato vuoto, utile quando serve mostrare che non viene inviato alcun parametro.
I parametri restano nel mio ordine?
Sì. Escono nell'ordine in cui i nomi compaiono nei suoi dati. Nell'esempio name, city, active e score mantengono quell'ordine, e il risultato indica anche quanti parametri ci sono.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/data/json-to-query-params \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"object":{"name":"Ada Lovelace","city":"London","active":true,"score":42}}'const res = await fetch("https://api.kit.forhosting.com/data/json-to-query-params", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"object": {
"name": "Ada Lovelace",
"city": "London",
"active": true,
"score": 42
}
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/data/json-to-query-params",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"object": {
"name": "Ada Lovelace",
"city": "London",
"active": true,
"score": 42
}
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/json-to-query-params", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"object":{"name":"Ada Lovelace","city":"London","active":true,"score":42}}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"object":{"name":"Ada Lovelace","city":"London","active":true,"score":42}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/json-to-query-params", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"object": {
"name": "Ada Lovelace",
"city": "London",
"active": true,
"score": 42
}
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "data.json_to_query_params",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 25 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
API, router front-end e pipeline di analitica spesso tengono filtri e campi di form come una semplice mappa JSON e hanno comunque bisogno di una query string correttamente codificata per la barra degli indirizzi o un client HTTP in uscita. Questa capacità accetta un oggetto JSON piatto, converte ogni valore scalare in testo, applica la codifica percent a ogni chiave e valore e restituisce la stringa pronta da appendere insieme a coppie ordinate e a una mappa di stringhe normalizzata. Oggetti e array annidati vengono rifiutati con invalid_input così il chiamante non emette mai spazzatura semi-strutturata che sembra un URL valido.
Da un oggetto piatto a una query string codificata
Quando la Sua fonte di verità è già un oggetto JSON —ad esempio uno stato di filtri, un modello di form o una mappa di configurazione— serve un modo deterministico per trasformare quella mappa nel formato di rete atteso da browser e server. Poiché il percorso è solo lavoro su stringhe e oggetti, senza rete, senza semi casuali e senza orologio di parete, input identici producono sempre JSON identico. Il prezzo API in caso di successo è la base pubblicata di $0.002 per elemento e i fallimenti di validazione non consumano il saldo prepagato.
Contratto di ingresso, forma della risposta ed errori
Il valore deve essere un oggetto piatto le cui proprietà siano stringhe, numeri, booleani o null. I numeri non finiti (NaN e Infinity) sono rifiutati perché non hanno una forma portabile standard nelle query string. Esempio: name Ada Lovelace, city London, active true e score quarantadue producono una stringa a quattro parametri con spazi e caratteri riservati codificati in percent. Invii con POST un corpo JSON con il campo obbligatorio object (alias json, data, params, map, fields). Può anche passare object come testo JSON che si analizza in tale mappa. Array al livello superiore, null, scalari e qualsiasi valore oggetto o array annidato falliscono con invalid_input e un messaggio inglese chiaro che nomina la chiave errata quando rilevante. In caso di successo la risposta include query (la stringa codificata senza punto interrogativo iniziale), query_with_prefix (la stessa con punto interrogativo iniziale, o solo il punto interrogativo se non ci sono chiavi), count (il numero di parametri), pairs (un array ordinato di stringhe key e value dopo la coercizione scalare e prima della codifica) e object (una mappa di stringhe last-wins di quei valori coerciti). Fallimento classico: inviare filtri annidati sotto una chiave filter uguale a un oggetto e ricevere invalid_input invece di un URL rotto in silenzio. Il prezzo API in caso di successo è la base pubblicata di $0.002 per elemento; i fallimenti di validazione non vengono fatturati.
Dove la conversione JSON-query ripaga
Gli autori di curricula sulle basi web vogliono una landing dedicata alla serializzazione oggetto-verso-query piuttosto che seppellire l’argomento sotto un parser bidirezionale, perché l’intento di ricerca differisce: chi ha una mappa JSON vuole la codifica, non le opzioni di modalità parse. Poiché l’implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita.
Casi di integrazione
Preparare parametri di query HTTP in uscita
Serializzi mappe di configurazione e di richiesta in un frammento di query sicuro per client, webhook e costruttori di URL firmati.
Fixture dorate per test di codifica
Generi query string stabili da fixture JSON in CI così spazi, ampersand e Unicode si codificano allo stesso modo a ogni esecuzione.
Domande tecniche
Come converto un oggetto JSON in una query string URL?
Invii un oggetto piatto nel campo object (o alias json, data, params). Il campo query della risposta contiene le coppie key=value codificate in percent unite da &; query_with_prefix aggiunge un ? iniziale.
E se il mio oggetto è annidato?
La capacità richiede un oggetto piatto. La struttura annidata fallisce con invalid_input così può appiattire o ridisegnare la mappa prima della codifica invece di inviare un URL ambiguo.
Quanto costa convertire un oggetto JSON in query string?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; l’input non valido non viene addebitato.