Installation

To begin working with HTTP requests in Python, you'll first need to ensure Python is installed on your system. Once Python is set up, you can install the requests library using pip:

pip install requests

Making HTTP Requests

The requests library supports various HTTP methods including GET, POST, PUT, and DELETE. Let's explore how to use these methods effectively.

GET Requests

Here's an example of sending a GET request to retrieve data from an API:

import requests

endpoint = 'https://api.example.com/data/1'
api_response = requests.get(endpoint)

if api_response.status_code == 200:
    _data = api_response.()
    print(_data)
else:
    print('Request failed with status code:', api_response.status_code)

In this example, we make a GET request to a specified endpoint. If the response status code is 200, we parse the JSON data from the response. Otherwise, we display an error message with the actual status code.

POST Requests

When you need to create new resources on a server, you'll use POST requests. Here's how to send data to an API:

import requests

api_url = 'https://api.example.com/resources'
payload = {'name': 'Sample Item', 'description': 'This is a test item', 'category': 'demo'}

server_response = requests.post(api_url, =payload)

if server_response.status_code == 201:
    created_resource = server_response.()
    print('Resource created with ID:', created_resource['id'])
else:
    print('Request failed with status code:', server_response.status_code)

This example demonstrates sending JSON data in the request body. A 201 status code indicates successful resource creation, after which we can extract the new resource's ID from the response.

Working with Responses

The requests library provides several methods to access different aspects of the response:

• Access response headers: response.headers
• Get text content: response.text
• Retrieve binary content: response.content
• Parse JSON data: response.()

Error Handling

Network requests can encounter various issues. The requests library raises exceptions for problems like connection errors or timeouts. You should implement proper error handling using try-except blocks:

try:
    response = requests.get('https://api.example.com/data')
    response.raise_for_status()  # Raises an exception for 4XX/5XX status codes
    data = response.()
    print(data)
except requests.exceptions.RequestException as e:
    print('An error occurred:', e)

Customizing Requests

You can enhance your requests by adding custom headers and parameters:

custom_headers = {'User-Agent': 'My-Application/1.0', 'Accept': 'application/'}
query_params = {'page': 1, 'per_page': 20}

api_response = requests.get('https://api.example.com/items', headers=custom_headers, params=query_params)

Session Management

For scenarios requiring persistent connections (like maintaining authentication), you can use Session objects:

with requests.Session() as session:
    session.headers.update({'Authorization': 'Bearer your_token_here'})
    response = session.get('https://api.example.com/protected_resource')
    print(response.())

Security and Timeouts

When working with HTTPS endpoints, you might need to specify SSL certificates. Additionally, it's good practice to set timeouts to prevent your application from hanging indefinitely:

try:
    response = requests.get(
        'https://secure-api.example.com/data',
        cert='/path/to/your/certificate.pem',
        timeout=(3.05, 27)  # (connect timeout, read timeout)
    )
    response.raise_for_status()
except requests.exceptions.SSLError as e:
    print('SSL verification failed:', e)
except requests.exceptions.Timeout as e:
    print('Request timed out:', e)