1.1. requests

● Simplifies making HTTP requests. ● Commonly used to consume RESTful APIs.

The requests library in Python simplifies the process of making HTTP requests. HTTP requests are used to communicate with web servers. The requests library makes it straightforward to send data over the internet and fetch data from external resources like APIs. RESTful APIs, which stand for Representational State Transfer Application Programming Interfaces, allow developers to access and manipulate data on a server through standard HTTP methods like GET, POST, PUT, and DELETE.

Think of the requests library as a postal service. Just like you can send a letter (HTTP request) to a friend (web server) asking for information or to deliver a message, the requests library allows you to send requests to web APIs to retrieve or send data.

import requests
response = requests.get("https://api.example.com/data")
print(response.json())

In this example, you see how to make a GET request using the requests library. The GET method is used to retrieve data from a specified URL. Here, the API endpoint is 'https://api.example.com/data'. After this request is made, the server responds with data, which we then convert into JSON format using the .json() method for easy handling.

Imagine you are ordering a book online. When you click 'Order', the bookstore receives your request (GET request), packages the book (data) and sends it back to you; in programming, we request data similarly from web services.

Example: POST Request

payload = {"title": "foo", "body": "bar", "userId": 1}
response = requests.post("https://jsonplaceholder.typicode.com/posts", json=payload)
print(response.status_code) # 201 means created
print(response.json())

A POST request is used to send data to a server to create or update a resource. In this example, we are sending some data (payload) to create a new post. We're using the 'json' parameter to send JSON formatted data. After the request, we check the status code to confirm if the operation was successful; a status code of 201 means that a new entry was created successfully.

Think of the POST request like submitting a form in a restaurant to order a meal. You provide your order information (payload) on the form, and when the server (restaurant staff) receives it, they prepare your meal and confirm that your order has been placed.

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://api.example.com/protected", headers=headers)

When dealing with secure APIs, you often need to provide authorization to access protected resources. This is done by including an API key in the request headers. The 'Authorization' header contains your key which validates your access rights. If you don’t include the proper authentication, you might receive an error indicating that you're unauthorized.

This is similar to showing an ID card (API Key) to enter a private event. Without showing your ID, the security personnel (API) won't allow you into the venue (access the data).

Always handle timeouts, status codes, and error checking when working with APIs.

When interacting with APIs, it's crucial to check for responses to avoid program crashes or unexpected behavior. HTTP status codes help you determine whether the request was successful (e.g., 200 means OK, 404 means Not Found). You should also handle timeouts to deal with situations where the server does not respond.

Consider this like receiving feedback on a job application: if you're approved (status code 200), great! If not found (404), you know your application was not submitted. Similarly, a timeout is akin to not hearing back at all—a sign that you need to follow up or resend your application.

--