Mac终端中用cURL命令行POST JSON到Cisco Spark API报错

我明白你遇到的问题了——直接在命令行用-d参数传JSON时总是报错，但用文件方式（比如-d @data.json）就能成功，对吧？核心问题出在shell的引号处理和变量解析规则上，咱们一步步来解决：

问题根源 #

你原来的命令用了单引号'包裹JSON内容：

curl -H "Content-Type: application/json" -H "$header" -i -v -X POST -d '{ "roomId": "$roomid", "text": "$message" }' https://api.ciscospark.com/v1/messages

在shell里，单引号内的所有字符都会被当作纯字符串，包括$roomid和$message这两个变量——也就是说API收到的不是你实际的房间ID和消息内容，而是字符串"$roomid"和"$message"，这自然会触发API的参数校验错误。

解决方案 #

这里有几种可靠的处理方式，你可以根据自己的需求选择：

1. 转义双引号，用双引号包裹JSON

把包裹JSON的单引号改成双引号，同时转义JSON内部的双引号（避免shell把它们当成字符串结束符），这样变量就能被正常解析了：

curl -H "Content-Type: application/json" -H "$header" -i -v -X POST -d "{ \"roomId\": \"$roomid\", \"text\": \"$message\" }" https://api.ciscospark.com/v1/messages

这种方式适合简单的JSON结构，缺点是要手动转义所有双引号，容易遗漏。

2. 先把JSON存入变量，再传给cURL

先将构造好的JSON内容赋值给一个变量，再把变量传给-d参数，这样更清晰也不容易出错：

# 构造JSON变量（注意转义内部双引号）
json_payload="{ \"roomId\": \"$roomid\", \"text\": \"$message\" }"

# 执行cURL请求
curl -H "Content-Type: application/json" -H "$header" -i -v -X POST -d "$json_payload" https://api.ciscospark.com/v1/messages

如果JSON结构比较复杂，推荐用heredoc来构造变量，不用手动转义双引号：

# 用heredoc生成JSON，自动解析变量
json_payload=$(cat <<EOF
{
  "roomId": "$roomid",
  "text": "$message"
}
EOF
)

curl -H "Content-Type: application/json" -H "$header" -i -v -X POST -d "$json_payload" https://api.ciscospark.com/v1/messages

3. 用printf安全生成JSON（适合bash 4.4+）

如果你的bash版本在4.4及以上，可以用printf来自动处理变量和JSON格式，避免手动转义：

# 用printf格式化生成JSON，自动替换变量
printf -v json_payload '{ "roomId": "%s", "text": "%s" }' "$roomid" "$message"

curl -H "Content-Type: application/json" -H "$header" -i -v -X POST -d "$json_payload" https://api.ciscospark.com/v1/messages

这种方式还能自动处理变量中的一些特殊字符（比如空格），让JSON格式更严谨。

为什么传文件方式能成功？ #

当你用-d @filename时，cURL会直接读取文件里的原始内容，不会经过shell的变量解析和引号处理，所以文件里的JSON结构和变量替换（如果文件里已经是最终内容的话）都是正确的，自然能成功提交。

内容的提问来源于stack exchange，提问作者Ronald Coe Jr.