resty完整用户指南：从基础操作到高级配置

resty完整用户指南：从基础操作到高级配置

【免费下载链接】restyLittle command line REST client that you can use in pipelines (bash or zsh).项目地址: https://gitcode.com/gh_mirrors/res/resty

resty是一款基于curl的轻量级命令行REST客户端，专为在bash或zsh管道中高效使用而设计。它提供简洁的shell接口来与REST服务交互，让你无需重复输入冗长的curl命令即可轻松发送HTTP请求，是开发者日常接口测试和数据处理的得力助手。

快速上手：5分钟入门resty

安装步骤

获取resty非常简单，只需一行curl命令即可：

curl -L https://raw.githubusercontent.com/micha/resty/master/resty > resty

下载完成后，在当前shell中加载resty：

. resty

基础配置

设置默认的REST服务地址：

resty http://127.0.0.1:8080/data

设置成功后会显示：http://127.0.0.1:8080/data*，表示后续请求将以此为基础URL。

发送第一个请求

现在你可以使用HTTP动词命令发送请求：

# 获取资源 GET /blogs.json # 创建资源 POST /blogs.json '{"title": "新文章", "content": "resty使用指南"}' # 更新资源 PUT /blogs/1.json '{"title": "更新文章", "content": "resty高级使用技巧"}' # 删除资源 DELETE /blogs/1

核心功能解析

请求方法全覆盖

resty支持所有常用HTTP方法，每个方法都对应一个直观的命令：

• GET：获取资源，如GET /users
• POST：创建资源，如POST /items '{"name":"test"}'
• PUT：全量更新资源，如PUT /config '{"debug":true}'
• PATCH：部分更新资源
• DELETE：删除资源
• HEAD：获取响应头信息
• OPTIONS：获取支持的HTTP方法

智能路径处理

resty会自动处理URL编码，让你无需手动转义特殊字符。例如：

# 自动编码特殊字符 GET /search?q=hello world # 等价于手动编码 GET '/search?q=hello%20world' -Q

数据输入灵活多样

resty支持多种数据输入方式：

• 直接在命令行提供数据：POST /data '{"key":"value"}'
• 从文件读取数据：PUT /config < config.json
• 从管道接收数据：generate_data.sh | POST /import
• 交互式编辑数据：GET /item/1 | PUT -V（-V选项会打开编辑器）

高级配置技巧

自定义请求头

通过curl参数传递自定义请求头：

GET /api -H "Authorization: Bearer token" -H "Accept: application/json"

保存常用配置

创建~/.resty/localhost:8080文件，为特定主机预设请求参数：

# ~/.resty/localhost:8080 GET -H "Accept: application/json" POST -H "Content-Type: application/json" -u user:pass

之后请求该主机时会自动应用这些配置：

resty localhost:8080 GET /data # 自动包含Accept头 POST /submit # 自动包含Content-Type头和认证信息

输出格式化

使用项目提供的工具美化JSON输出：

# 使用pp工具 GET /complex.json | pp # 使用pypp工具（Python实现） GET /complex.json | pypp

实用场景示例

批量数据处理

结合jsawk工具实现JSON数据处理流水线：

# 获取用户列表，更新状态后提交 GET /users | jsawk 'this.active = true' | PUT /users/batch

脚本集成

在shell脚本中使用resty：

#!/usr/bin/env bash . ./resty -W 'https://api.example.com/v1*' # 获取数据并处理 data=$(GET /data) processed=$(echo "$data" | jq '.results[]') # 提交处理结果 POST /results "$processed"

调试技巧

使用-v选项获取详细请求信息：

GET /debug -v # 显示完整的curl请求过程

常见问题解决

路径记忆功能

resty会记住上次使用的路径，方便连续操作同一资源：

GET /items/123 # 首次指定路径 PUT '{"status":"completed"}' # 无需重复路径

如需禁用此功能，设置环境变量：

RESTY_NO_PRESERVE_PATH=true

处理HTML响应

默认情况下，resty会尝试格式化HTML响应。如需原始输出，使用-Z选项：

GET /page.html -Z # 输出原始HTML内容

退出状态码

resty使用特殊的退出状态码反映HTTP响应状态：

• 0：成功（2xx状态码）
• 1：1xx状态码
• 3：3xx状态码
• 4：4xx状态码
• 5：5xx状态码

安装方式选择

除了基础的curl安装，resty还支持多种包管理器：

• Bpkg：bpkg install -g micha/resty
• Antigen：在.zshrc中添加antigen bundle micha/resty
• Zplug：在.zshrc中添加zplug micha/resty, use:'resty'
• Oh My Zsh：克隆仓库到$ZSH_CUSTOM/plugins/resty，并添加到plugins列表

通过本指南，你已经掌握了resty的核心功能和高级用法。无论是日常接口测试还是复杂的自动化脚本，resty都能帮你简化工作流程，提高效率。开始使用resty，体验命令行REST客户端的强大魅力吧！

要获取最新版本的resty，可以通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/res/resty

【免费下载链接】restyLittle command line REST client that you can use in pipelines (bash or zsh).项目地址: https://gitcode.com/gh_mirrors/res/resty