PUT method - Python requests

The requests library is a powerful and user-friendly tool in Python for making HTTP requests. The PUT method is one of the key HTTP request methods used to update or create a resource at a specific URI.

Working of HTTP PUT Method

• If the resource exists at the given URI, it is updated with the new data.
• If the resource does not exist, the server can create it at that URI.
• The request includes the data to be stored in the request body.
• It's idempotent, meaning sending the same request multiple times results in the same outcome (unlike POST).

Syntax

requests.put(url, params={key: value}, **args)

Parameters:

• url: The target endpoint.
• data: Dictionary or string to be sent in the body (often form or JSON data).
• args: Optional parameters like headers, authentication, timeout, etc.

Installation

To use the requests module, we need to first install it using this command:

pip install requests

Example – Making a PUT Request

In this example, we are going to make a real PUT Request using httpbin.org, a public testing API.

import requests

res = requests.put('https://httpbin.org/put', data={'key': 'value'})

print("Status Code:", res.status_code)

print("Response Body:", res.content.decode())

Output:

Explanation:

• requests.put() sends the PUT request to the specified URL.
• data parameter inside requests.put() is used to pass the key-value data to be updated or created on the server.
• print(r) displays the response object, including the HTTP status code (e.g., 200 for success).
• print(r.content) prints the response body returned by the server after processing the PUT request.