Da JSON a Query String
Create una query string URL da un oggetto JSON. Ogni valore viene codificato tramite codifica percentuale, gli oggetti annidati usano la notazione con parentesi quadre, come filter[status]=open, e gli array vengono scritti come chiavi ripetute, con parentesi quadre, con indici o come elenchi separati da virgole. Scegliete %20 o + per gli spazi in base al server che legge l'URL.
Domande frequenti
Quali formati di array sono disponibili?
Repeat scrive ids=1&ids=2, brackets scrive ids[]=1&ids[]=2, indices scrive ids[0]=1&ids[1]=2 e comma scrive ids=1,2. Repeat è il formato usato da URLSearchParams e dalla maggior parte dei client HTTP; PHP e Rails si aspettano brackets o indices.
Come vengono scritti gli oggetti annidati?
Con la notazione tra parentesi quadre: {"filter": {"status": "open"}} diventa filter[status]=open. Gli oggetti più profondi aggiungono altre parentesi, ad esempio a[b][c]=1.
Gli spazi devono essere %20 o +?
Entrambi indicano uno spazio in una stringa di query. %20 è corretto in qualsiasi parte di una URL, mentre + è ciò che inviano i moduli HTML. La maggior parte dei server accetta entrambi, quindi scegliete quello usato dal vostro server o dalla documentazione di API.
Perché le parentesi quadre vengono codificate come %5B e %5D?
Le parentesi quadre sono caratteri riservati negli URL, quindi per impostazione predefinita vengono codificate in percentuale, come fanno http_build_query di PHP e la libreria qs. Attivate le parentesi leggibili per mantenerle come [ e ], che la maggior parte dei server accetta comunque.
Quali caratteri non vengono codificati?
Le lettere, le cifre e i caratteri - _ . ! ~ * ' ( ) restano invariati. Tutto il resto, inclusi &, =, # e le lettere non ASCII, viene codificato in percentuale come UTF-8.
Come vengono scritti i valori null e booleani?
true, false e i numeri vengono scritti come testo, ad esempio active=true. null diventa un valore vuoto, ad esempio note=.