执行 POST 请求的 cURL 命令行语法是什么？

Question

如何使用cURL命令行工具发出POST请求？

Answer 1

带字段：

curl --data "param1=value1&param2=value2" https://example.com/resource.cgi

单独指定字段：

curl --data "param1=value1" --data "param2=value2" https://example.com/resource.cgi

多部分：

curl --form "fileupload=@my-file.txt" https://example.com/resource.cgi

带有字段和文件名的多部分：

curl --form "fileupload=@my-file.txt;filename=desired-filename.txt" --form param1=value1 --form param2=value2 https://example.com/resource.cgi

没有数据：

curl --data '' https://example.com/resource.cgi

curl -X POST https://example.com/resource.cgi

curl --request POST https://example.com/resource.cgi

有关更多信息，请参阅cURL 手册。有关模拟 Web 浏览器的cURL 教程很有帮助。

使用 libcurl，curl_formadd()在以通常方式提交表单之前使用该函数构建表单。有关更多信息，请参阅libcurl 文档。

对于大文件，考虑添加参数以显示上传进度：

curl --tr-encoding -X POST -v -# -o output -T filename.dat \
  http://example.com/resource.cgi

将-o output是必需的，否则没有进度条就会出现。

Answer 2

对于包含 XML 的 RESTful HTTP POST：

curl -X POST -d @filename.txt http://example.com/path/to/resource --header "Content-Type:text/xml"

或者对于 JSON，使用这个：

curl -X POST -d @filename.txt http://example.com/path/to/resource --header "Content-Type:application/json"

这将读取命名文件的内容filename.txt并将其作为发布请求发送。

Answer 3

来自标准输入的数据 -d @-

例子：

echo '{"text": "Hello **world**!"}' | curl -d @- https://api.github.com/markdown

输出：

<p>Hello <strong>world</strong>!</p>

Answer 4

curl -d "name=Rafael%20Sagula&phone=3320780" http://www.where.com/guest.cgi 

是在Curl Example Manual 中找到的示例。

如果上述方法不起作用，请使用 %26 作为＆符号：

curl -d "name=Rafael%20Sagula%26phone=3320780" http://www.where.com/guest.cgi 

Answer 5

如果要登录到站点，请执行以下操作：

curl -d "username=admin&password=admin&submit=Login" --dump-header headers http://localhost/Login
curl -L -b headers http://localhost/

第一个请求将会话 cookie（成功登录时提供）保存在“headers”文件中。从现在开始，您可以使用该 cookie 对您在使用浏览器登录后通常访问的网站的任何部分进行身份验证。

Answer 6

如果你懒惰，你可以让 google-chrome 或 firefox 为你做所有的工作。

1. 右键单击要提交的表单，然后选择Inspect（或Inspect Element for Firefox）。这将打开 DevTools 面板。
2. 在 devtools 中选择Network选项卡并勾选 Preserve log复选框（Persist Logs for firefox）。
3. 提交表单并使用方法 POST 找到条目（右键单击任何列标题并确保选中方法）。
4. 右键单击带有 POST 的行，然后选择Copy > Copy as cURL。

Chrome 将以 cURL 语法复制所有请求数据。

Chrome 使用--data 'param1=hello&param2=world'它，您可以通过使用单个-d或-F每个参数来提高可读性，具体取决于您要发送的 POST 请求类型，可以是application/x-www-form-urlencoded或multipart/form-data相应的。

这将被发布为application/x-www-form-urlencoded（用于大多数不包含文件上传的表单）：

curl http://httpbin.org/post \
    -H "User-Agent: Mozilla/2.2" \
    -d param1=hello \
    -d name=dinsdale

对于multipart/form-dataPOST 使用-F（通常用于包含文件上传的表单，或者字段顺序很重要，或者需要多个具有相同名称的字段）：

curl http://httpbin.org/post \
    -H "User-Agent: Mozilla/2.2" \
    -F param1=hello \
    -F name=dinsdale \
    -F name=piranha

^{该User-Agent头通常不需要，但我万一扔了。如果您需要自定义代理，那么您可以通过创建~/.curlrc包含例如User-Agent: "Mozilla/2.2"}

Answer 7

curl -v --data-ascii var=value http://example.com

还有更多选项，请curl --help查看更多信息。