How to do a PUT request with cURL?

How to Use cURL to Execute PUT Requests?

cURL is a powerful command-line tool for data transfer, supporting various protocols including HTTP, HTTPS, FTP, etc. PUT requests are typically used for updating resources. Below, I will provide a detailed explanation of how to use cURL to execute PUT requests, along with a specific example.

1. Basic Command Structure

To send a PUT request using cURL, use the -X PUT option, where -X specifies the request type:

bash
curl -X PUT [URL]

2. Adding Data

If you need to send data to the server, use the -d or --data parameter to include it. The data can be in formats such as plain text, JSON, or XML, depending on the API requirements.

For example, to update a resource using JSON format, the command might appear as:

bash
curl -X PUT -H "Content-Type: application/json" -d '{"key1":"value1", "key2":"value2"}' [URL]

Here, -H adds HTTP headers to specify the content type as JSON.

3. Example

Suppose we have a RESTful API with URL http://example.com/api/item, and we need to update an item's data.

The item ID is 10, and we want to change the name from "OldName" to "NewName".

The request body in JSON format is:

json
{
  "id": 10,
  "name": "NewName"
}

The complete cURL command is:

bash
curl -X PUT -H "Content-Type: application/json" -d '{"id": 10, "name": "NewName"}' http://example.com/api/item/10

4. Verification and Debugging

To ensure your PUT request executes as expected, use the -v (or --verbose) option for detailed output, which aids in debugging:

bash
curl -v -X PUT -H "Content-Type: application/json" -d '{"id": 10, "name": "NewName"}' http://example.com/api/item/10

This will display detailed information about the request and response, including the HTTP method, headers, and status code.

The above outlines a basic approach for executing PUT requests with cURL, accompanied by a practical example. I hope this is helpful! If you have further questions or need additional explanations, please feel free to ask.