JSONPath
AI 驱动的 JSONPath 生成器
快速开始
JSON 响应示例
假设我们有以下 JSON 响应：
{
"store": {
"book": [
{ "category": "fiction", "author": "Author A", "title": "Book 1" },
{ "category": "reference", "author": "Author B", "title": "Book 2" },
{ "category": "fiction", "author": "Author C", "title": "Book 3" }
]
}
}
提取数据
要提取数组中第一本 此表达式返回 "Book 1"。
book 的 title，请使用此 JSONPath 表达式： $.store.book[0].titleJSONPath 表达式说明
让我们分解表达式 总之，该表达式从根节点开始导航，找到
$.store.book[0].title：$：指 JSON 文档的根节点——本质上是整个结构。store：指向 store 属性，它是根节点下的一个对象。book：访问 store 对象下的 book 属性，它是一个数组。[0]：选择 book 数组中的第一个元素（索引从 0 开始）。title：获取数组中第一本书的 title。store 对象，访问 book 数组，选择第一项，并提取该项的 title。重要说明
0 开始。$.store.book[?(@.category=='reference')]。语法概览
基础语法
| 语法 | 描述 |
|---|---|
$ | 根节点 |
@ | 当前节点 |
.node 或 ['node'] | 访问子节点 |
[index] | 数组索引，支持从 0 开始计数 |
[start:end:step] | 数组切片 |
* | 通配符，匹配所有子节点 |
.. | 递归通配符，匹配所有后代节点 |
(<expr>) | 动态表达式 |
?(<boolean expr>) | 过滤条件 |
扩展语法
| 语法 | 描述 |
|---|---|
^ | 访问匹配项的父级 |
~ | 获取匹配项的属性名称（作为数组） |
@null(), @boolean(), @number(), @string(), @array(), @object() | 检索基本 JSON 类型 |
@integer() | 检索整数类型 |
@scalar() | 检索复杂类型，接受 undefined 和非有限数字（查询 JavaScript 对象时） |
@other() | 可与用户定义的 otherTypeCallback 一起使用 |
@undefined(), @function(), @nonFinite() | 查询非 JSON JavaScript 对象时使用的非 JSON 类型 |
@path, @parent, @property, @parentProperty, @root | 过滤器中的简写选择器 |
` | 转义剩余序列 |
@['...'], ?@['...'] | 在过滤器中转义属性名称中的特殊字符 |
$.. | 检索所有父级组件 |
JSONPath 示例
示例 JSON 数据
{
"store": {
"book": [
{
"category": "reference",
"author": "Nigel Rees",
"title": "Sayings of the Century",
"price": 8.95
},
{
"category": "fiction",
"author": "Evelyn Waugh",
"title": "Sword of Honour",
"price": 12.99
},
{
"category": "fiction",
"author": "Herman Melville",
"title": "Moby Dick",
"isbn": "0-553-21311-3",
"price": 8.99
},
{
"category": "fiction",
"author": "J. R. R. Tolkien",
"title": "The Lord of the Rings",
"isbn": "0-395-19395-8",
"price": 22.99
}
],
"bicycle": {
"color": "red",
"price": 19.95
}
}
}常见查询示例
| XPath | JSONPath | 结果 |
|---|---|---|
/store/book/author | $.store.book[*].author | 所有书籍的作者 |
//author | $..author | 所有作者 |
/store/* | $.store.* | store 下的所有子节点 |
/store//price | $.store..price | 所有价格字段 |
//book[3] | $..book[2] | 第三本书（从 0 开始的索引） |
//book[last()] | $..book[(@.length-1)] 或 $..book[-1:] | 最后一本书 |
//book[position()<3] | $..book[:2] 或 $..book[0,1] | 前两本书 |
//book[isbn] | $..book[?(@.isbn)] | 带有 ISBN 的书籍 |
//book[price<10] | $..book[?(@.price<10)] | 价格低于 10 的书籍 |
//* | $..* | 递归匹配所有子节点 |
测试 JSONPath 表达式
Apidog 中的使用场景
参考资料
Modified at 2026-06-09 08:55:47