macos快捷指令处理json数据需“获取url内容”+“解析json”+“提取值”三步闭环：先用“获取url内容”拉取api响应，再通过“获取词典值”显式解析并识别结构（对象用键名、数组用循环），最后按需提取字段或拼接文本。
在 macos 快捷指令中处理 json 数据，核心是“获取 url 内容”+“解析 json”+“提取值”三步闭环。它不依赖编程，但需要理解 json 结构和快捷指令的操作逻辑。
如何把 JSON 数据导入快捷指令
JSON 数据通常来自网络 API，所以第一步是用获取 URL 内容操作拉取原始文本：
- 输入目标接口地址（如
https://api.example.com/users） - 可选设置请求方法（GET/POST）、请求头（如
Content-Type: application/json或认证 token） - 若需 POST 提交 JSON，先用“文本”操作拼出合法 JSON 字符串，再配合“获取 URL 内容”的“正文”字段发送
怎样正确解析 JSON 并识别结构
快捷指令不会自动识别 JSON，必须显式触发解析：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 将“获取 URL 内容”的输出，连接到获取词典值操作——这个操作会自动尝试解析输入文本为 JSON
- 如果输入不是合法 JSON，会报错；若成功，后续就能按键名取值（如
name、id）或按索引取列表项 - 不确定结构时，先用“显示结果”看原始响应，确认是对象（
{...}）还是数组（[...]），再决定用“获取词典值”还是“获取列表项目”
从解析结果中提取你需要的字段
解析后，数据变成快捷指令可操作的变量结构：
- 对词典（对象）：用获取词典值，填入键名（如
first_name），支持多层嵌套（如user.profile.email） - 对列表（数组）：用重复操作遍历每一项，每轮循环中再用“获取词典值”取单个字段
- 混合结构常见，例如
{"data": [{"id":1,"title":"A"},{"id":2,"title":"B"}]}，需先取data键得列表，再循环取每个子项的title
常见问题与绕过技巧
遇到解析失败或字段取不到，多数不是语法错，而是结构误判：
- 服务器返回带 HTML 包裹或前缀的 JSON（如
)]}',{...}），需先用“文本”操作截掉多余字符 - 日期、数字被当字符串处理？可在“获取词典值”后接“转换为数字”或“格式化日期”操作
- 想把多个字段拼成一行文本（如“张三 - 28岁”），用“文本”操作组合，插入变量时点“+”号选择对应字段即可
