Linux 怎么抓接口返回值？curl 结合 jq 实战

linux下抓接口返回值最常用高效的方式是curl + jq组合：curl发起http请求获取原始响应，jq解析jsON精准提取字段；需先安装jq，再用-s静默模式、-H加请求头、-d发POST数据，配合.r去引号、-e判错等参数实现干净稳定可复用的提取。

Linux 下抓接口返回值，最常用也最高效的方式就是 curl + jq 组合：curl 负责发起 HTTP 请求并获取原始响应，jq 负责解析 json 并精准提取字段。关键不是“能不能拿到”，而是“怎么拿得干净、稳定、可复用”。

先确认环境有没有 jq

很多 Linux 发行版默认不带 jq，直接运行会报 command not found：

• ubuntu/debian：sudo apt install jq
• centos/RHEL/Fedora：sudo yum install jq 或 sudo dnf install jq
• macOS（Homebrew）：brew install jq

装好后执行 jq --version 确认可用。

基础用法：GET 请求 + 提取单个字段

比如调用 gitHub API 查用户信息：

curl -s "https://api.github.com/users/octocat" | jq '.name, .public_repos'

说明：

• -s 静默模式，屏蔽进度条和错误提示（适合脚本）
• | jq '.name' 表示从 JSON 中取 name 字段值（字符串自动带双引号）
• .public_repos 是数字字段，jq 默认不加引号输出
• 想去除引号用 -r（raw 输出），如：jq -r '.name'

处理带认证或请求头的接口

多数生产接口需要 Token 或 header：

ChatDOC

ChatDOC是一款基于chatgpt的文件阅读助手，可以快速从pdf中提取、定位和总结信息

262

查看详情

curl -s -H "Authorization: Bearer abc123"       -H "Content-Type: application/json"       "https://api.example.com/v1/data" | jq -r '.items[0].id'

注意点：

• -H 可多次使用添加多个 header
• .items[0].id 表示取数组第一个对象的 id 字段；越深的路径越要小心空值，否则 jq 会输出 NULL
• 加 -e 参数可让 jq 在遇到 null 或解析失败时返回非零退出码，方便 Shell 判断是否成功

POST 请求 + 提取响应中的关键数据

发送 JSON 数据并解析返回结果：

curl -s -X POST       -H "Content-Type: application/json"       -d '{"username":"test","password":"123"}'       "https://api.example.com/login" | jq -r '.token'

说明：

• -X POST 显式指定方法（GET 是默认，可省略）
• -d 后跟 JSON 字符串，注意引号嵌套别出错；复杂数据建议写进文件再用 @file.json 引入
• 如果响应是纯文本或非 JSON，jq 会报错；可用 || true 忽略错误，或先用 head -c 100 检查前 100 字节是否含 {

基本上就这些。curl 抓回来的是“原料”，jq 是“切菜刀”——练熟几个常用语法（.、[0]、.[].xxx、-r、-e），90% 的接口调试和自动化取值都能稳稳拿下。