跳转到正文

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=。

关于 OneClick Pro

OneClick Pro 是一个免费的工具集合,包含超过 150 种网络工具,助你处理日常工作:转换图像和单位、格式化和验证代码、检查域名和 SEO,以及处理文本、日期和数字。所有工具均可免注册、免订阅使用;你输入的内容仅用于计算结果,绝不会被存储。你可以将它用作处理临时任务的快捷工具箱,也可以收藏每天都会用到的工具。