cURL Generator

简介

把请求参数转成 cURL，方便在终端复现。

下列说明侧重开发者如何在本站 API 目录选型后，用该工具完成联调与文档协作；具体功能与版本以官方产品为准。

类型

在线工具

相关链接

此类能力也可在本地 IDE、命令行（如 jq、python -m json.tool）或团队批准的内网工具中完成；选用时请优先可信环境，避免将生产密钥粘贴到未知网页。

能做什么

cURL 生成器把 URL、方法、Header、Body 转成可在终端复现的命令，便于写入工单、Runbook 或交给运维在不打开 GUI 的情况下重放请求。

典型工作流

• 在客户端配好鉴权与表单/JSON Body
• 导出 cURL → 在 shell 验证
• 去掉敏感头后存入文档
• 必要时加 --compressed/-v 诊断

何时用

需要脚本化、CI 或远程服务器上复现问题时。Postman/Insomnia 也自带 cURL 导出。

注意点

命令历史可能泄露 Key，使用 env var 替代内联 Secret；注意 shell 转义与 multipart 边界。

与 API 目录配合

从 API 详情页确认官方 base URL 与必填 Header 后，再生成 cURL 交给后端或 SRE 在服务器复现。把可公开的命令片段放进 Runbook，密钥与 Token 用环境变量在部署系统注入，勿写入仓库。

团队实践

On-call 手册按「现象 → cURL 复现 → 期望状态码」三段式编写。Windows 同事可用 Git Bash 或 WSL 运行同一命令，避免 PowerShell 转义差异导致误判。长 Body 建议改用文件引用 curl -d @payload.json，便于版本管理。上传文件接口记得在命令里保留 -F 与 MIME 类型，否则服务端解析会静默失败。