Cú pháp dòng lệnh cURL để thực hiện một yêu cầu POST là gì?

Làm cách nào tôi có thể thực hiện yêu cầu POST bằng công cụ dòng lệnh cURL ?

Với các trường:

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

Với các trường được chỉ định riêng:

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

Đa mục:

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

Đa mục với các trường và tên tệp:

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

Không có dữ liệu:

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

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

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

Để biết thêm thông tin, xem hướng dẫn của CURL . Các cURL hướng dẫn về thi đua một trình duyệt web là hữu ích.

Với libcurl, sử dụng curl_formadd()chức năng để xây dựng biểu mẫu của bạn trước khi gửi nó theo cách thông thường. Xem tài liệu libcurl để biết thêm thông tin.

Đối với các tệp lớn, hãy xem xét thêm tham số để hiển thị tiến trình tải lên:

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

Các -o outputyêu cầu, nếu không không có thanh tiến trình sẽ xuất hiện.

Đối với POST HTTP RESTful chứa XML:

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

hoặc cho JSON, sử dụng cái này:

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

Điều này sẽ đọc nội dung của tệp có tên filename.txtvà gửi nó dưới dạng yêu cầu bài viết.

Dữ liệu từ stdin với -d @-

Thí dụ:

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

Đầu ra:

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

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

là ví dụ được tìm thấy trong Hướng dẫn ví dụ Curl .

Sử dụng% 26 cho ký hiệu thay thế nếu cách trên không hoạt động:

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

Nếu bạn muốn đăng nhập vào một trang web, hãy làm như sau:

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

Yêu cầu đầu tiên lưu cookie phiên (được cung cấp khi đăng nhập thành công) trong tệp "tiêu đề". Từ giờ bạn có thể sử dụng cookie đó để xác thực bạn với bất kỳ phần nào của trang web mà bạn thường truy cập sau khi đăng nhập bằng trình duyệt.

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

và có nhiều lựa chọn hơn, kiểm tra curl --helpđể biết thêm thông tin.

Nếu bạn lười biếng, bạn có thể lấy google-chrome để làm tất cả công việc cho bạn.

1. Bấm chuột phải vào biểu mẫu bạn muốn gửi và chọn Kiểm tra . Điều này sẽ mở bảng DevTools.
2. Chọn tab Mạng trong devtools và đánh dấu vào hộp kiểm Bảo tồn nhật ký .
3. Gửi biểu mẫu và định vị mục nhập bằng phương thức POST (nhấp chuột phải vào bất kỳ tiêu đề cột nào và đảm bảo Phương thức được chọn).
4. Nhấp chuột phải vào dòng bằng POST và chọn Sao chép > Sao chép dưới dạng cURL .

Chrome sẽ sao chép tất cả dữ liệu yêu cầu theo cú pháp cURL.

Chrome sử dụng --data 'param1=hello&param2=world'mà bạn có thể dễ đọc hơn bằng cách sử dụng một -dhoặc -Fmột tham số tùy thuộc vào loại yêu cầu POST bạn muốn gửi, có thể là một trong hai application/x-www-form-urlencodedhoặc multipart/form-datatheo đó.

Đây sẽ là POST-ed dưới dạng application/x-www-form-urlencoded( được sử dụng cho phần lớn các biểu mẫu không chứa tệp tải lên ):

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

Đối với multipart/form-dataviệc sử dụng POST -F( thường được sử dụng với các biểu mẫu có chứa tệp tải lên hoặc trong đó thứ tự các trường là quan trọng hoặc trong đó yêu cầu nhiều trường có cùng tên ):

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

^{Các User-Agenttiêu đề không bình thường cần thiết, nhưng tôi đã ném nó trong chỉ trong trường hợp. Bạn có thể tránh phải đặt tác nhân người dùng theo mọi yêu cầu bằng cách tạo ~/.curlrctệp chứa vdUser-Agent: "Mozilla/2.2"}