如何使用cURL发送JSON数据？
如何使用cURL发送JSON数据？您可以使用 cURL 通过添加 Content-Type 标头并使用 `--post`或 `--post`选项
传递 JSON 正文来 POST JSON ，例如：-d--json
curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com
简答：一行命令
如果您只是想使用复制粘贴的方式，那么这是使用 cURL 发送 JSON 的最快方法。大多数开发者使用简单的内联有效负载并指定 Content-Type 标头。对于标准的 Unix shell，常用的模式如下：
curl -X POST -H "Content-Type: application/json" -d '{"name":"John","age":30}' https://api.example.com/users
之所以有效，是因为该-X POST标志设置了你的方法，请求头告诉服务器你的请求体是 JSON 格式，并将-d原始有效负载作为请求体附加。在 Reddit 的 r/webdev 版块，用户@andrewbuilds直言不讳地说：“十有八九，这就是人们想要的 curl POST 示例。”
使用 cURL 发送 JSON 的常用方法
使用 -d 或 --data 参数内联 JSON
内联 JSON 非常适合快速测试或轻量级有效负载。大多数开发者在验证端点或检查 API 是否可达时都会使用内联 JSON。请记住，Unix shell 更倾向于使用单引号将 JSON 键括起来，这样可以避免意外地断开 JSON 主体内的双引号。我看到 r/devops 上的工程师提到，这通常是初学者容易犯错的地方——尤其是在直接从文档复制 JSON 时。内联 JSON 快速、简洁，是简单 API 调用的理想选择。
使用 -d @file 从文件发送 JSON 数据
当处理较大的 JSON 数据、多行配置或在终端中容易出错的对象时，最好将 JSON 数据保存在文件中。只需创建一个类似这样的文件payload.json，然后运行：
curl -X POST -H "Content-Type: application/json" -d @payload.json https://api.example.com/process
后端开发人员广泛使用这种方法来实现自动化任务或测试 API 工作流程。X 的一位工程师@jake_the_builder开玩笑说，从文件中加载 JSON “可以让你免于转义引号的折磨，还能避免你的终端看起来像犯罪现场”。在使用 Residential Proxy 控制面板或 OkeyProxy 等工具时，这种方法也更加简洁，因为这些工具通常会返回更深层次、嵌套更复杂的 JSON 结构。
使用较新的 --json 选项
现代版本的 cURL 包含一个非常方便的--json快捷方式。它会自动设置 Content-Type 标头并配置 POST 请求，无需额外的标志：
curl --json '{"email":"[email protected]"}' https://api.example.com/login
这个选项非常棒，因为它能减少人为错误。在 Facebook 开发者群组中，用户@melissacodes表示她--json现在只用这个方法，因为“它省去了我以前每天都要重写的所有样板代码”。如果你的 cURL 版本支持，这绝对是最简洁的语法。
平台和外壳的容易让人犯错
Windows PowerShell 和 CMD 引用规则
如果你使用的是 Windows 系统，你的命令需要不同的转义方式。PowerShell 要求 JSON 键用双引号括起来，并且内部引号需要转义。通常类似这样的命令就可以了：
curl -X POST -H "Content-Type: application/json" -d "{\"user\":\"sam\"}" https://api.example.com/login
CMD 的行为有所不同，Stack Exchange 上的许多用户都抱怨这种不一致性。开发者通常会在 Git Bash 或 WSL 中测试 API 调用，因为使用引号会更可预测。在管理代理配置或测试多个 IP 端点时，能够重用简洁的 Unix 风格命令可以节省大量时间。
多行 JSON、stdin 和 here-doc 技巧
为了获得更易读的有效负载，您可以将 JSON 数据通过管道传递给 cURL。这使得您的命令更易于维护，尤其是在脚本中：
echo '{ "task": "sync", "priority": "high" }' | curl --json @- https://api.example.com/jobs
在调试或从 IDE 复制代码块时，这种方法感觉更自然。Reddit 上，r/programming 用户@kevinwritescode表示，他已转而使用基于标准输入的帖子，因为这样可以“避免人们在引号和空格方面犯的 90% 的错误”。
高级选项和实用变体
使用 --data-binary 参数可获得精确的物体精度
有时 API 要求请求体保持原样，不进行任何换行或格式更改。这时 `--no-body`--data-binary就派上用场了。它会原封不动地保留你提供的请求体。使用严格基于签名的身份验证或与验证原始请求字节的服务交互的开发者会依赖此功能。如果你要批量提交结构化配置文件或代理会话令牌，这通常是最安全的标志。
添加标头、身份验证令牌和查询参数
大多数生产环境 API 都需要某种形式的身份验证。您可以像这样附加 Bearer 令牌或自定义标头：
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" --json '{"ping":1}' https://api.example.com/ping
这在代理行业很常见，尤其是在轮换住宅IP或管理API配额时。许多网络社区用户建议将令牌存储在环境变量中，而不是将其硬编码到命令中。
TLS 和证书说明
cURL 支持自定义证书、客户端身份验证和更严格的 TLS 验证。虽然可以使用 `--disable-certificate-checks` 禁用证书检查--insecure，但大多数安全专家强烈建议不要这样做。正如一位名叫@ryansec的工程师在 X 论坛上写道：“如果你在开发环境中关闭了 TLS 检查，你很可能会忘记在生产环境中重新启用它们。” 请谨慎使用此功能，并且仅在你真正信任目标时才使用。
调试、测试和常见服务器错误
使用 -v 或 -i 显示请求和响应标头
调试 API 调用时，查看响应头和原始响应会更加容易。使用 `cURL.htaccess`-v可以全面了解 cURL 发送的内容，包括 TLS 协商和请求元数据。`cURL.htaccess`-i还允许您查看服务器的响应头。这在排查 JSON 解析问题或测试行为取决于响应头的动态端点时至关重要。
常见错误及解决方法
最常见的错误是忘记添加 Content-Type 标头。服务器经常返回 false 415 Unsupported Media Type，这意味着它们无法识别你的请求体是 JSON。第二个大问题是引用错误——尤其是在 Windows 系统上。另一个常见问题是发送格式错误的 JSON。当服务器返回 false 时400 Bad Request，请使用在线 JSON 验证器检查你的请求体，或者运行带有 `cURL` 参数的命令-v来查看你实际发送的内容。后端开发人员@lindseycodes在 Instagram 上提到，她总是在将 JSON 数据提交到生产 API 之前，使用快速格式化工具进行测试。
最佳实践和快速安全检查清单
良好的 API 卫生至关重要。发送 JSON 数据前务必进行验证。避免将 API 密钥直接嵌入到命令历史记录中。--json为了保持一致性，建议使用基于文件的 JSON 数据。测试速率限制或用户特定流程时，请轮换 IP 地址——许多 QA 测试人员会将 cURL 与 OkeyProxy 等住宅代理服务结合使用，以模拟真实用户环境。此外，请务必清理日志。调试跟踪可能会暴露您不希望泄露的标头信息。
快速提供可直接用于工作流程的示例，方便您撰写文案。
Unix 风格的内联有效载荷：
curl -X POST -H "Content-Type: application/json" -d '{"a":1}' https://api.example.com/test
PowerShell 版本：
curl -X POST -H "Content-Type: application/json" -d "{\"a\":1}" https://api.example.com/test
基于文件的JSON：
curl --json @payload.json https://api.example.com/process
使用 Bearer 代币的示例：
curl -X POST -H "Authorization: Bearer TOKEN" --json '{"task":"run"}' https://api.example.com/run
常见问题解答
如何在 Windows 上使用 cURL 发送 JSON 请求？
请求体中需要使用转义的双引号。PowerShell 对 JSON 字符串有特殊处理。
为什么我会收到 415 不支持的媒体类型错误？
通常是因为您忘记添加 Content-Type 标头，或者您的 JSON 格式错误。
我可以发送文件中的 JSON 数据而不是直接在代码中输入吗？
可以，使用`json.json`-d @filename.json或 ` --json @filename.jsonjson.json-include` 可以得到更简洁、更易于维护的命令。
-d、--data-binary 和 --json 有什么区别？-d
-d用于格式化数据，--data-binary保留完整的数据正文，并--json自动处理数据头。
我可以直接将 JSON 数据通过管道传递给 cURL 吗？
可以，使用 stdin：echo '{"a":1}' | curl --json @- https://...这样可以保持命令简洁。
