HTTP Request Builder

从命令行界面构建、测试和保存HTTP请求,支持自定义请求头、认证、请求体、Cookie、模板、交互模式及请求历史记录。

安装

概览

HTTP Request Builder 是一款专为开发者设计的命令行工具,旨在通过终端快速构建、测试和保存 HTTP 请求。它允许用户发送包含自定义请求头、认证信息、请求体和 Cookie 的 HTTP 请求,并支持将常用请求保存为模板以便重复使用。该工具特别适合需要在脚本或自动化流程中频繁调用 API 的场景,提供了一种轻量级但功能完整的替代方案,尤其适用于那些偏好 CLI 而非图形界面(如 Postman)的开发者。 作为一款基于 Python 的命令行工具,HTTP Request Builder 支持多种 HTTP 方法(GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS),并允许用户在交互模式或脚本模式下灵活配置请求参数。无论是简单的 GET 查询还是复杂的带 JSON 体的 POST 请求,都可以通过简洁的命令完成。此外,它还提供了请求历史记录功能,方便用户追踪最近的调用情况,而无需重新输入所有参数。 尽管该工具没有复杂的 GUI 界面,但其设计专注于高效性和可集成性。它不依赖外部服务,所有数据(如模板和历史记录)均本地存储在 `~/.http-request-builder/` 目录下,确保隐私与离线可用性。虽然目前仅支持 Basic Auth 和 Bearer Token 两种认证方式,且缺乏高级特性如 OAuth 或环境变量替换,但对于大多数 RESTful API 的测试与调试任务而言,已足够强大和实用。

核心功能特点

  1. 支持多种 HTTP 方法:包括 GET、POST、PUT、DELETE、PATCH、HEAD 和 OPTIONS,满足各种 API 操作需求
  2. 灵活的请求配置:可设置自定义请求头、请求体(JSON/表单/原始文本)、Cookie 及认证信息(Basic Auth、Bearer Token)
  3. 模板化请求管理:可将常用请求保存为 JSON 模板文件,随时加载执行,便于复用和团队协作
  4. 交互式请求构建:提供分步引导的交互模式,适合不熟悉命令语法的用户逐步创建复杂请求
  5. 请求历史记录:自动记录最近 100 次 HTTP 调用,支持查看和清除,方便回溯调试
  6. 命令行驱动:完全基于终端操作,易于集成到 shell 脚本或 CI/CD 流程中进行自动化测试

适用场景

HTTP Request Builder 最适合需要快速测试 REST API 接口的开发者和运维人员。例如,当你在开发后端服务时,经常需要通过命令行验证某个端点是否按预期返回数据,此时可以直接使用 `get` 命令发送请求,立即查看响应状态和内容,极大提升调试效率。对于频繁调用的接口,比如用户注册或数据上报,你可以先通过交互式模式配置好请求头、认证和 JSON 体,然后保存为模板,后续只需一条命令即可重放,避免重复输入繁琐参数。 该工具也非常适合自动化场景。如果你正在编写部署脚本或持续集成流水线,可以将 HTTP Request Builder 嵌入其中,用于在发布前检查 API 健康状态、触发 webhook 或同步配置。由于其输出为标准 JSON 格式,结合 jq 等工具还能轻松提取关键信息进行断言。此外,团队成员之间共享 API 请求配置也变得简单——只需导出模板文件即可,无需依赖特定 GUI 软件,确保一致性。 即使在日常工作中遇到网络问题或接口变更,HTTP Request Builder 也能派上用场。你可以复现失败的请求以分析原因,或者对比新旧版本的响应差异。虽然它不支持 WebSocket、multipart 文件上传或 HTTP/2 等高级协议,但对于绝大多数传统 REST API 场景,它提供了一个稳定、可预测且无需联网的本地测试环境。