Kapow! + jq：2个Shell示例教你快速构建JSON API服务

Kapow! jq2个Shell示例教你快速构建JSON API服务【免费下载链接】kapowKapow! If you can script it, you can HTTP it.项目地址: https://gitcode.com/gh_mirrors/ka/kapowKapow是一个开源的命令行工具口号是 If you can script it, you can HTTP it——只要你能写出一个 Shell 脚本就能把它变成一个 HTTP API。本文将结合jqJSON 处理神器通过2 个 Shell 示例教你用不到 10 行代码快速构建一个JSON API 服务无需写一行 Web 框架代码。什么是 Kapow把 Shell 命令变成 HTTP APIKapow 的工作方式非常简单你写一个可执行的初始化脚本init program用kapow route add声明要暴露的 HTTP 端点启动kapow server后每次收到请求就会自动执行脚本里定义的命令。下图展示了 Kapow 的 JSON API 请求生命周期用户发起 HTTP 请求后Kapow 会派生spawn一个 Shell 进程执行你定义的命令命令通过kapow set把结果写回响应体最后把 response 返回给用户。核心就靠 3 个客户端命令命令作用kapow route add注册一个 HTTP 端点路径 请求方法 执行命令kapow get /request/body读取请求体等请求内容kapow set /response/body把内容写入响应体、响应头、状态码示例 1自动修正请求 JSON 中的日期POST jq 改写场景客户端发来一个日期字段错误的 JSON服务端自动补上正确的当前时间并返回。创建可执行脚本fix_date$ cat fix_date #!/usr/bin/env sh kapow route add -X POST /fix-date - -EOF kapow set /response/headers/Content-Type application/json kapow get /request/body | jq --arg newdate $(date %Y-%m-%d_%H-%M-%S) .incorrectDate$newdate | kapow set /response/body EOF原理拆解kapow get /request/body取出请求的 JSON 原文管道交给jq用--arg注入当前时间重写incorrectDate字段kapow set /response/body把修好的 JSON 写回响应。用 curl 调用试试$ curl -X POST http://localhost:8080/fix-date -H Content-Type: application/json -d {incorrectDate: no way, Jose} { incorrectDate: 2019-11-22_10-42-06 }错误日期被自动修好了。✅示例 2提取请求字段动态拼装 JSON 响应场景从请求体里提取name字段动态生成一个包含两个属性的 JSON 问候响应。创建可执行脚本echo-attribute$ cat echo-attribute #!/usr/bin/env sh kapow route add -X POST /echo-attribute - -EOF JSON_WHO$(kapow get /request/body | jq -r .name) kapow set /response/headers/Content-Type application/json kapow set /response/status 200 jq --arg greet Hello --arg value ${JSON_WHO:-World} --null-input { greet: $greet, to: $value } | kapow set /response/body EOF几个亮点jq -r .name一行命令完成 JSON 字段提取-r输出不带引号的原始值${JSON_WHO:-World}使用了 Shell 默认值语法——请求里没传name时自动回退为World天然容错jq --null-input可以从零开始构造一个新的 JSON 对象。调用效果$ curl -X POST http://localhost:8080/echo-attribute -H Content-Type: application/json -d {name: MyName} { greet: Hello, to: MyName }快速部署启动并验证你的 JSON API 服务两个示例的完整流程都是三步$ chmod x fix_date # 1. 赋予脚本可执行权限 $ kapow server fix_date # 2. 启动服务默认监听 8080 端口 $ curl -X POST http://localhost:8080/fix-date -d {incorrectDate: x} # 3. 验证如果你想让它对外通过 HTTPS 提供服务启动时加上证书参数即可$ kapow server --keyfile path/to/keyfile --certfile path/to/certfile fix_date进阶技巧URL 路径参数与并行执行Kapow 还支持在路由里声明{参数}例如/parallel/{ip1}/{ip2}然后用kapow get /request/matches/ip1取值配合 Shell 的与wait实现并行请求。更多技巧可以参考 shell_tricks.rst。参考资料与延伸阅读本文示例完整出处using_json.rst快速上手指南含企业内网 HTTP API 部署场景quickstart.rst安装与配置二进制 / go get / Docker 三种方式install_and_configure.rst服务端核心实现internal/server/路由与资源树概念routes.rst、resource_tree.rst⚠️ 安全提示Kapow 会把 HTTP 请求映射为服务器上的命令执行请务必限定可执行的命令范围、使用最小权限账户运行并在生产环境启用 mTLS参考 https_mtls.rst。输出文章【免费下载链接】kapowKapow! If you can script it, you can HTTP it.项目地址: https://gitcode.com/gh_mirrors/ka/kapow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考