JSON 转 Query String
根据 JSON 对象生成 URL 查询字符串。所有值都会进行百分号编码;嵌套对象使用 filter[status]=open 这样的方括号记法;数组则可写为重复键、带方括号、带索引或逗号分隔的列表。可选择用 %20 或 + 表示空格,以匹配读取 URL 的服务器。
常见问题
有哪些数组格式可选?
Repeat 格式会生成 ids=1&ids=2;brackets 格式会生成 ids[]=1&ids[]=2;indices 格式会生成 ids[0]=1&ids[1]=2;comma 格式会生成 ids=1,2。URLSearchParams 和大多数 HTTP 客户端都会发送 Repeat 格式;PHP 和 Rails 则要求使用方括号或索引格式。
嵌套对象如何写入?
使用方括号表示法:{"filter": {"status": "open"}} 会变成 filter[status]=open。更深层的对象会增加更多方括号,例如 a[b][c]=1。
空格应该写成 %20 还是 +?
在查询字符串中,两者都表示空格。%20 在 URL 的任何部分都适用,而 + 是 HTML 表单会发送的形式。大多数服务器两种都接受,因此请根据服务器或 API 文档选择。
为什么方括号会被编码为 %5B 和 %5D?
方括号是 URL 中的保留字符,因此默认会进行百分号编码,例如 PHP 的 http_build_query 和 qs 库都会这样处理。启用可读方括号后,它们会保留为 [ 和 ],大多数服务器也能接受这种形式。
哪些字符不会被编码?
字母、数字以及 - _ . ! ~ * ' ( ) 会保持原样。其他所有字符,包括 &, =, # 和非 ASCII 字母,都会按 UTF-8 进行百分号编码。
null 和布尔值如何表示?
true、false 和数字会写成文本,例如 active=true。null 会变成空值,例如 note=。