Why use HTTP methods when performing operations?

HTTP methods (GET, POST, PUT, PATCH, DELETE) define the type of action performed on a resource on the server. This provides:

• Semantic clarity: Each method clearly indicates the client's intent (retrieve, create, update, delete a resource).
• Caching: The GET method is cached by default, enhancing performance. Other methods that change state are usually not cached.
• Idempotency: Some methods (GET, PUT, DELETE) are idempotent, meaning multiple executions of the same operation yield the same result as a single execution. This is important for reliability and retries. POST is not idempotent.
• Security: Separating methods helps implement security policies, restricting access to certain operations.
• Standardization: Using standard methods simplifies interaction between different systems and tools.
• Error tracking: HTTP status codes (e.g., 200 OK, 404 Not Found) are more informative in the context of a specific method, indicating the result of the request.

Example:

import requests

# Retrieve resource
response_get = requests.get("https://api.example.com/users/123")
print(f"GET Status: {response_get.status_code}")

# Create resource
data_post = {"name": "John Doe", "email": "john.doe@example.com"}
response_post = requests.post("https://api.example.com/users", json=data_post)
print(f"POST Status: {response_post.status_code}")

# Update resource
data_put = {"name": "Jane Doe"}
response_put = requests.put("https://api.example.com/users/123", json=data_put)
print(f"PUT Status: {response_put.status_code}")

# Partial update of resource
data_patch = {"email": "jane.doe.updated@example.com"}
response_patch = requests.patch("https://api.example.com/users/123", json=data_patch)
print(f"PATCH Status: {response_patch.status_code}")

# Delete resource
response_delete = requests.delete("https://api.example.com/users/123")
print(f"DELETE Status: {response_delete.status_code}")